> ## Documentation Index
> Fetch the complete documentation index at: https://deepline.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Attention Create Kbsource: Inputs, Cost & CLI Example

> Create KB Source. Attention Attention Create Kbsource docs include request fields, response shape, pricing notes, and Deepline CLI examples.

## Run in Enrichment Spreadsheet

<Info>
  Use this function as a column step in `deepline enrich`.
</Info>

```bash theme={null}
deepline enrich --input leads.csv --output leads.enriched.csv --with 'result=attention_create_kbsource:{"title":"{{title}}"}' --json
```

<Tip>
  Map payload values to spreadsheet columns with `{{column_name}}` placeholders.
</Tip>

## Input Schema

| Name              | Type                                             | Required | Default           | Description                                                                                 |
| ----------------- | ------------------------------------------------ | -------- | ----------------- | ------------------------------------------------------------------------------------------- |
| `payload.title`   | `string`                                         | Yes      |                   | Title of the KB source                                                                      |
| `payload.content` | `string`                                         | No       |                   | Content of the source (required for manual entries)                                         |
| `payload.format`  | `"text/markdown" \| "text/html" \| "text/plain"` | No       | `"text/markdown"` | Content format (defaults to text/markdown). For PDF files, use the upload endpoint instead. |

### Allowed values

| Field            | Allowed values                             |
| ---------------- | ------------------------------------------ |
| `payload.format` | `text/markdown`, `text/html`, `text/plain` |

<details>
  <summary>Show raw input schema</summary>

  ### Input JSON Schema

  ```json theme={null}
  {
    "type": "object",
    "description": "Creates a new knowledge base source with inline content. Automatically triggers indexing for vector search. For file uploads, use the upload endpoint instead.",
    "properties": {
      "title": {
        "type": "string",
        "description": "Title of the KB source",
        "maxLength": 500
      },
      "content": {
        "type": "string",
        "description": "Content of the source (required for manual entries)",
        "maxLength": 524288
      },
      "format": {
        "type": "string",
        "description": "Content format (defaults to text/markdown). For PDF files, use the upload endpoint instead.",
        "default": "text/markdown",
        "enum": [
          "text/markdown",
          "text/html",
          "text/plain"
        ]
      }
    },
    "required": [
      "title"
    ],
    "additionalProperties": false
  }
  ```
</details>

## Output Schema

| Name          | Type     | Required | Default | Description                                    |
| ------------- | -------- | -------- | ------- | ---------------------------------------------- |
| `result.data` | `object` | Yes      |         | Provider response payload.                     |
| `result.meta` | `object` | No       |         | Additional response metadata (status, paging). |

<details>
  <summary>Show raw output schema</summary>

  ### Output JSON Schema

  ```json theme={null}
  {
    "type": "object",
    "description": "Standard tool result payload.",
    "properties": {
      "data": {
        "type": "object",
        "description": "Provider response payload.",
        "properties": {
          "data": {
            "type": "object",
            "properties": {
              "type": {
                "type": "string",
                "description": "Resource type"
              },
              "id": {
                "type": "string",
                "description": "Unique identifier of the KB source"
              },
              "attributes": {
                "type": "object",
                "properties": {
                  "title": {
                    "type": "string",
                    "description": "Title of the KB source"
                  },
                  "source_type": {
                    "type": "string",
                    "description": "Type of source: manual (inline content) or upload (S3 file)",
                    "enum": [
                      "manual",
                      "upload"
                    ]
                  },
                  "content": {
                    "type": "string",
                    "description": "Content of the source (present on get, absent on list)"
                  },
                  "format": {
                    "type": "string",
                    "description": "Content format (e.g. text/markdown, application/pdf, text/html, text/plain)"
                  },
                  "status": {
                    "type": "string",
                    "description": "Processing status of the source",
                    "enum": [
                      "pending",
                      "uploading",
                      "indexing",
                      "indexed",
                      "failed"
                    ]
                  },
                  "file_size": {
                    "type": "integer",
                    "description": "File size in bytes"
                  },
                  "chunk_count": {
                    "type": "integer",
                    "description": "Number of indexed chunks"
                  },
                  "created_at": {
                    "type": "string",
                    "description": "Creation timestamp",
                    "format": "date-time"
                  },
                  "updated_at": {
                    "type": "string",
                    "description": "Last update timestamp",
                    "format": "date-time"
                  }
                },
                "additionalProperties": false
              }
            },
            "additionalProperties": false
          }
        },
        "additionalProperties": false
      },
      "meta": {
        "type": "object",
        "description": "Additional response metadata (status, paging).",
        "additionalProperties": true
      }
    },
    "required": [
      "data"
    ],
    "additionalProperties": false
  }
  ```
</details>

## Advanced: Direct CLI

<Info>
  Use direct execution for single payload debugging.
</Info>

```bash theme={null}
deepline tools execute attention_create_kbsource --payload '{
  "title": "string"
}' --json
```

### CLI flags

| Flag                        | Description                                         |
| --------------------------- | --------------------------------------------------- |
| `--json`                    | Print machine-readable output.                      |
| `--wait`                    | Wait for terminal provider status when supported.   |
| `--debug`                   | Enable wait mode with additional status/log output. |
| `--wait-timeout SECONDS`    | Max seconds to wait in wait mode.                   |
| `--poll-interval SECONDS`   | Polling interval in seconds during wait mode.       |
| `--timeout SECONDS`         | Request timeout in seconds.                         |
| `--connect-timeout SECONDS` | Connection timeout in seconds.                      |

## Cost

* Pricing model: `fixed` (per call).
* Estimated Deepline credits: `0` per pricing unit.
* Provider-native pricing may still exist outside Deepline credit billing.
* Billing mode: `no_bill`.