> ## 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 Field Configuration Item

> Create Field Configuration Item. Includes SDK V2 guidance, input constraints, response fields, and Deepline credit cost.

Create Field Configuration Item.

<Info>
  Tool ID: `attention_create_field_configuration_item`
</Info>

## Run this action

Use the TypeScript SDK for a single call. Put `ctx.tools.execute(...)` inside a Play when the call should be durable, scheduled, or run across a CSV.

```ts theme={null}
import { Deepline } from 'deepline';

const deepline = await Deepline.connect();
const result = await deepline.tools.execute(
  'attention_create_field_configuration_item',
  {
    "id": "id_123",
    "title": "VP of Engineering",
    "category": "CRM",
    "contents": "example",
    "promptType": "example",
    "contentType": "example"
  },
);

console.log(result.toolResponse.raw);
```

### CLI

```bash theme={null}
deepline tools execute attention_create_field_configuration_item --input '{
  "id": "id_123",
  "title": "VP of Engineering",
  "category": "CRM",
  "contents": "example",
  "promptType": "example",
  "contentType": "example"
}' --json
```

## Example response

The SDK exposes this shape at `result.toolResponse.raw`. Values below are representative.

```json theme={null}
{
  "data": {
    "data": {
      "item": {
        "uuid": "uuid_123",
        "fieldConfigurationUUID": "field_configuration_123",
        "title": "VP of Engineering",
        "category": "CRM",
        "contents": "example",
        "promptType": "example",
        "contentType": "example",
        "allowLongResponse": true,
        "extractQuotes": true,
        "availableToAllClients": true,
        "createdAt": "2026-01-15T12:00:00Z",
        "lastModifiedAt": "2026-01-15T12:00:00Z"
      },
      "assignments": [
        {
          "uuid": "uuid_123",
          "intelligenceItemUUID": "intelligence_item_123",
          "teamUUID": "team_123",
          "category": "example",
          "createdAt": "2026-01-15T12:00:00Z",
          "lastModifiedAt": "2026-01-15T12:00:00Z"
        }
      ]
    }
  }
}
```

Use `deepline tools get attention_create_field_configuration_item --json` for the latest machine-readable contract.

## Input reference

Request payload for creating a single new item inside a field configuration. The REST endpoint wraps this singular request into the underlying bulk creation path (ADR-9). Creating an item fans out into one `IntelligenceItemAssignment` per team the parent configuration is assigned to - the response returns the list of created assignments.

| Name | Type | Required | Default | Details |
| - | - | - | - | - |
| `payload.id` | `string` | Yes | — | UUID of the field configuration. |
| `payload.title` | `string` | Yes | — | Short human-readable title of the item. Trimmed; 1-128 characters. |
| `payload.category` | `"CRM" \| "Indicators" \| "BuiltInInsight" \| "CustomInsight"` | Yes | — | Category of the item. Allowed: `CRM`, `Indicators`, `BuiltInInsight`, `CustomInsight`. |
| `payload.contents` | `string` | Yes | — | Prompt text that Attention will evaluate against each conversation. |
| `payload.description` | `string` | No | — | Optional longer description. 0-2000 characters. |
| `payload.promptType` | `string` | Yes | — | Prompt family used to analyze the conversation. |
| `payload.contentType` | `string` | Yes | — | Expected shape of the extracted content. |
| `payload.responseType` | `string` | No | — | Optional response data type hint. |
| `payload.options` | `array` | No | — | Optional allowed response values for multiple-choice items. |
| `payload.dependsOn` | `array` | No | — | UUIDs of other items this item depends on. |
| `payload.maxValues` | `integer` | No | — | Maximum number of values allowed for multi-select items. |
| `payload.allowLongResponse` | `boolean` | No | — | Whether the analyzer may produce a longer free-text response. |
| `payload.extractQuotes` | `boolean` | No | — | Whether the analyzer should attach supporting quotes to the response. |
| `payload.analysisLevel` | `"conversation" \| "deal" \| "lead" \| "contact" \| "account"` | No | — | Level at which the item is evaluated. Allowed: `conversation`, `deal`, `lead`, `contact`, `account`. |
| `payload.metadata` | `object` | No | — | Numeric scoring metadata for a field-configuration item. Required when the item represents a numeric score - `min_score` must be less than or equal to `max_score`. |
| `payload.displayOrder` | `integer` | No | — | Optional starting position in the team's ordered item list; existing assignments at or after this position are shifted by one. |
| `payload.requestStage` | `integer` | No | — | Optional analysis stage in which the resulting assignments are evaluated. |

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

  ### Input JSON Schema

  ```json theme={null}
  {
    "type": "object",
    "description": "Request payload for creating a single new item inside a field configuration. The REST endpoint wraps this singular request into the underlying bulk creation path (ADR-9). Creating an item fans out into one `IntelligenceItemAssignment` per team the parent configuration is assigned to - the response returns the list of created assignments.",
    "properties": {
      "id": {
        "type": "string",
        "description": "UUID of the field configuration."
      },
      "title": {
        "type": "string",
        "description": "Short human-readable title of the item. Trimmed; 1-128 characters."
      },
      "category": {
        "type": "string",
        "description": "Category of the item.",
        "enum": [
          "CRM",
          "Indicators",
          "BuiltInInsight",
          "CustomInsight"
        ]
      },
      "contents": {
        "type": "string",
        "description": "Prompt text that Attention will evaluate against each conversation."
      },
      "description": {
        "type": "string",
        "description": "Optional longer description. 0-2000 characters."
      },
      "promptType": {
        "type": "string",
        "description": "Prompt family used to analyze the conversation."
      },
      "contentType": {
        "type": "string",
        "description": "Expected shape of the extracted content."
      },
      "responseType": {
        "type": "string",
        "description": "Optional response data type hint."
      },
      "options": {
        "type": "array",
        "description": "Optional allowed response values for multiple-choice items.",
        "items": {
          "type": "string"
        }
      },
      "dependsOn": {
        "type": "array",
        "description": "UUIDs of other items this item depends on.",
        "items": {
          "type": "string"
        }
      },
      "maxValues": {
        "type": [
          "integer",
          "null"
        ],
        "description": "Maximum number of values allowed for multi-select items."
      },
      "allowLongResponse": {
        "type": "boolean",
        "description": "Whether the analyzer may produce a longer free-text response."
      },
      "extractQuotes": {
        "type": "boolean",
        "description": "Whether the analyzer should attach supporting quotes to the response."
      },
      "analysisLevel": {
        "type": "string",
        "description": "Level at which the item is evaluated.",
        "enum": [
          "conversation",
          "deal",
          "lead",
          "contact",
          "account"
        ]
      },
      "metadata": {
        "type": "object",
        "description": "Numeric scoring metadata for a field-configuration item. Required when the item represents a numeric score - `min_score` must be less than or equal to `max_score`.",
        "properties": {
          "min_score": {
            "type": "number",
            "description": "Minimum allowed score value.",
            "format": "double"
          },
          "max_score": {
            "type": "number",
            "description": "Maximum allowed score value.",
            "format": "double"
          },
          "middle_score": {
            "type": [
              "number",
              "null"
            ],
            "description": "Optional midpoint score value, used by scoring heuristics.",
            "format": "double"
          },
          "min_criteria": {
            "type": "string",
            "description": "Human-readable description of what the minimum score means."
          },
          "max_criteria": {
            "type": "string",
            "description": "Human-readable description of what the maximum score means."
          },
          "middle_criteria": {
            "type": [
              "string",
              "null"
            ],
            "description": "Human-readable description of what the middle score means."
          }
        },
        "additionalProperties": false
      },
      "displayOrder": {
        "type": [
          "integer",
          "null"
        ],
        "description": "Optional starting position in the team's ordered item list; existing assignments at or after this position are shifted by one."
      },
      "requestStage": {
        "type": "integer",
        "description": "Optional analysis stage in which the resulting assignments are evaluated."
      }
    },
    "required": [
      "id",
      "category",
      "contentType",
      "contents",
      "promptType",
      "title"
    ],
    "additionalProperties": false
  }
  ```
</details>

## Output reference

Standard tool result payload.

| Name | Type | Required | Default | Details |
| - | - | - | - | - |
| `result.data` | `object` | Yes | — | Envelope returned when a field-configuration item is created. The `data.assignments` array documents the fan-out (one entry per team the parent configuration is assigned to). |
| `result.data.data` | `object` | No | — | Create-item payload: the newly created item plus the fan-out `IntelligenceItemAssignment` rows - one per team the parent field configuration is assigned to. |
| `result.data.data.item` | `object` | No | — | A single field within a Field Configuration (internally `IntelligenceItem`). Items describe a prompt that Attention evaluates against a conversation and produces a value for. A field-configuration item is cloned as one `IntelligenceItemAssignment` per team the parent configuration is assigned to - see `IntelligenceItemAssignment`. |
| `result.data.data.item.uuid` | `string` | Yes | — | Unique identifier of the item. |
| `result.data.data.item.fieldConfigurationUUID` | `string` | Yes | — | UUID of the parent field configuration. |
| `result.data.data.item.title` | `string` | Yes | — | Short human-readable title of the item. Trimmed; 1-128 characters. |
| `result.data.data.item.category` | `"CRM" \| "Indicators" \| "BuiltInInsight" \| "CustomInsight"` | Yes | — | Category of the item. One of the intelligence-category enum values. Allowed: `CRM`, `Indicators`, `BuiltInInsight`, `CustomInsight`. |
| `result.data.data.item.contents` | `string` | Yes | — | Prompt text that Attention will evaluate against each conversation. |
| `result.data.data.item.description` | `string` | No | — | Optional longer description shown to end users. 0-2000 characters. |
| `result.data.data.item.promptType` | `string` | Yes | — | Prompt family used to analyze the conversation. |
| `result.data.data.item.contentType` | `string` | Yes | — | Expected shape of the extracted content. |
| `result.data.data.item.responseType` | `string` | No | — | Optional response data type hint. |
| `result.data.data.item.options` | `array` | No | — | Optional allowed response values when the item is a multiple-choice field. |
| `result.data.data.item.dependsOn` | `array` | No | — | UUIDs of other items this item depends on. |
| `result.data.data.item.maxValues` | `integer` | No | — | Maximum number of values allowed for multi-select items. |
| `result.data.data.item.allowLongResponse` | `boolean` | Yes | — | Whether the analyzer may produce a longer free-text response. |
| `result.data.data.item.extractQuotes` | `boolean` | Yes | — | Whether the analyzer should attach supporting quotes to the response. |
| `result.data.data.item.availableToAllClients` | `boolean` | Yes | — | Internal flag marking the item as globally available. |
| `result.data.data.item.analysisLevel` | `"conversation" \| "deal" \| "lead" \| "contact" \| "account"` | No | — | Level at which the item is evaluated. Allowed: `conversation`, `deal`, `lead`, `contact`, `account`. |
| `result.data.data.item.metadata` | `object` | No | — | Numeric scoring metadata for a field-configuration item. Required when the item represents a numeric score - `min_score` must be less than or equal to `max_score`. |
| `result.data.data.item.metadata.min_score` | `number` | No | — | Minimum allowed score value. Format: `double`. |
| `result.data.data.item.metadata.max_score` | `number` | No | — | Maximum allowed score value. Format: `double`. |
| `result.data.data.item.metadata.middle_score` | `number \| null` | No | — | Optional midpoint score value, used by scoring heuristics. Format: `double`. |
| `result.data.data.item.metadata.min_criteria` | `string` | No | — | Human-readable description of what the minimum score means. |
| `result.data.data.item.metadata.max_criteria` | `string` | No | — | Human-readable description of what the maximum score means. |
| `result.data.data.item.metadata.middle_criteria` | `string \| null` | No | — | Human-readable description of what the middle score means. |
| `result.data.data.item.createdAt` | `string` | Yes | — | Timestamp when the item was created. Format: `date-time`. |
| `result.data.data.item.lastModifiedAt` | `string` | Yes | — | Timestamp when the item was last updated. Format: `date-time`. |
| `result.data.data.assignments` | `array` | No | — | Assignment rows created as part of the fan-out. For a configuration assigned to N teams, N assignments are returned. |
| `result.data.data.assignments[].uuid` | `string` | Yes | — | Unique identifier of the assignment row. |
| `result.data.data.assignments[].intelligenceItemUUID` | `string` | Yes | — | UUID of the underlying field-configuration item this assignment points at. |
| `result.data.data.assignments[].teamUUID` | `string` | Yes | — | UUID of the team this assignment applies to. |
| `result.data.data.assignments[].organizationUUID` | `string` | No | — | UUID of the organization this assignment belongs to. |
| `result.data.data.assignments[].category` | `string` | Yes | — | Category of the underlying item (copied from the item at assignment time). |
| `result.data.data.assignments[].displayOrder` | `integer` | No | — | Position of this assignment in the team's ordered list of items. |
| `result.data.data.assignments[].requestStage` | `integer` | No | — | Analysis stage in which this assignment is evaluated. |
| `result.data.data.assignments[].createdAt` | `string` | Yes | — | Timestamp when the assignment was created. Format: `date-time`. |
| `result.data.data.assignments[].lastModifiedAt` | `string` | Yes | — | Timestamp when the assignment was last updated. Format: `date-time`. |
| `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": "Envelope returned when a field-configuration item is created. The `data.assignments` array documents the fan-out (one entry per team the parent configuration is assigned to).",
        "properties": {
          "data": {
            "type": "object",
            "description": "Create-item payload: the newly created item plus the fan-out `IntelligenceItemAssignment` rows - one per team the parent field configuration is assigned to.",
            "properties": {
              "item": {
                "type": "object",
                "description": "A single field within a Field Configuration (internally `IntelligenceItem`). Items describe a prompt that Attention evaluates against a conversation and produces a value for. A field-configuration item is cloned as one `IntelligenceItemAssignment` per team the parent configuration is assigned to - see `IntelligenceItemAssignment`.",
                "properties": {
                  "uuid": {
                    "type": "string",
                    "description": "Unique identifier of the item."
                  },
                  "fieldConfigurationUUID": {
                    "type": "string",
                    "description": "UUID of the parent field configuration."
                  },
                  "title": {
                    "type": "string",
                    "description": "Short human-readable title of the item. Trimmed; 1-128 characters."
                  },
                  "category": {
                    "type": "string",
                    "description": "Category of the item. One of the intelligence-category enum values.",
                    "enum": [
                      "CRM",
                      "Indicators",
                      "BuiltInInsight",
                      "CustomInsight"
                    ]
                  },
                  "contents": {
                    "type": "string",
                    "description": "Prompt text that Attention will evaluate against each conversation."
                  },
                  "description": {
                    "type": "string",
                    "description": "Optional longer description shown to end users. 0-2000 characters."
                  },
                  "promptType": {
                    "type": "string",
                    "description": "Prompt family used to analyze the conversation."
                  },
                  "contentType": {
                    "type": "string",
                    "description": "Expected shape of the extracted content."
                  },
                  "responseType": {
                    "type": "string",
                    "description": "Optional response data type hint."
                  },
                  "options": {
                    "type": "array",
                    "description": "Optional allowed response values when the item is a multiple-choice field.",
                    "items": {
                      "type": "string"
                    }
                  },
                  "dependsOn": {
                    "type": "array",
                    "description": "UUIDs of other items this item depends on.",
                    "items": {
                      "type": "string"
                    }
                  },
                  "maxValues": {
                    "type": "integer",
                    "description": "Maximum number of values allowed for multi-select items."
                  },
                  "allowLongResponse": {
                    "type": "boolean",
                    "description": "Whether the analyzer may produce a longer free-text response."
                  },
                  "extractQuotes": {
                    "type": "boolean",
                    "description": "Whether the analyzer should attach supporting quotes to the response."
                  },
                  "availableToAllClients": {
                    "type": "boolean",
                    "description": "Internal flag marking the item as globally available."
                  },
                  "analysisLevel": {
                    "type": "string",
                    "description": "Level at which the item is evaluated.",
                    "enum": [
                      "conversation",
                      "deal",
                      "lead",
                      "contact",
                      "account"
                    ]
                  },
                  "metadata": {
                    "type": "object",
                    "description": "Numeric scoring metadata for a field-configuration item. Required when the item represents a numeric score - `min_score` must be less than or equal to `max_score`.",
                    "properties": {
                      "min_score": {
                        "type": "number",
                        "description": "Minimum allowed score value.",
                        "format": "double"
                      },
                      "max_score": {
                        "type": "number",
                        "description": "Maximum allowed score value.",
                        "format": "double"
                      },
                      "middle_score": {
                        "type": [
                          "number",
                          "null"
                        ],
                        "description": "Optional midpoint score value, used by scoring heuristics.",
                        "format": "double"
                      },
                      "min_criteria": {
                        "type": "string",
                        "description": "Human-readable description of what the minimum score means."
                      },
                      "max_criteria": {
                        "type": "string",
                        "description": "Human-readable description of what the maximum score means."
                      },
                      "middle_criteria": {
                        "type": [
                          "string",
                          "null"
                        ],
                        "description": "Human-readable description of what the middle score means."
                      }
                    },
                    "additionalProperties": false
                  },
                  "createdAt": {
                    "type": "string",
                    "description": "Timestamp when the item was created.",
                    "format": "date-time"
                  },
                  "lastModifiedAt": {
                    "type": "string",
                    "description": "Timestamp when the item was last updated.",
                    "format": "date-time"
                  }
                },
                "required": [
                  "allowLongResponse",
                  "availableToAllClients",
                  "category",
                  "contentType",
                  "contents",
                  "createdAt",
                  "extractQuotes",
                  "fieldConfigurationUUID",
                  "lastModifiedAt",
                  "promptType",
                  "title",
                  "uuid"
                ],
                "additionalProperties": false
              },
              "assignments": {
                "type": "array",
                "description": "Assignment rows created as part of the fan-out. For a configuration assigned to N teams, N assignments are returned.",
                "items": {
                  "type": "object",
                  "description": "One row of the fan-out produced when a field-configuration item is created or updated: a single item is expanded into N `IntelligenceItemAssignment` rows, one per team the parent configuration is assigned to.",
                  "properties": {
                    "uuid": {
                      "type": "string",
                      "description": "Unique identifier of the assignment row."
                    },
                    "intelligenceItemUUID": {
                      "type": "string",
                      "description": "UUID of the underlying field-configuration item this assignment points at."
                    },
                    "teamUUID": {
                      "type": "string",
                      "description": "UUID of the team this assignment applies to."
                    },
                    "organizationUUID": {
                      "type": "string",
                      "description": "UUID of the organization this assignment belongs to."
                    },
                    "category": {
                      "type": "string",
                      "description": "Category of the underlying item (copied from the item at assignment time)."
                    },
                    "displayOrder": {
                      "type": "integer",
                      "description": "Position of this assignment in the team's ordered list of items."
                    },
                    "requestStage": {
                      "type": "integer",
                      "description": "Analysis stage in which this assignment is evaluated."
                    },
                    "createdAt": {
                      "type": "string",
                      "description": "Timestamp when the assignment was created.",
                      "format": "date-time"
                    },
                    "lastModifiedAt": {
                      "type": "string",
                      "description": "Timestamp when the assignment was last updated.",
                      "format": "date-time"
                    }
                  },
                  "required": [
                    "category",
                    "createdAt",
                    "intelligenceItemUUID",
                    "lastModifiedAt",
                    "teamUUID",
                    "uuid"
                  ],
                  "additionalProperties": false
                }
              }
            },
            "additionalProperties": false
          }
        },
        "additionalProperties": false
      },
      "meta": {
        "type": "object",
        "description": "Additional response metadata (status, paging).",
        "additionalProperties": true
      }
    },
    "required": [
      "data"
    ],
    "additionalProperties": false
  }
  ```
</details>

## Deepline cost

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

## Related documentation

* [Attention provider guide](/docs/providers/attention/guide)
* [SDK V2 quickstart](/docs/sdk-v2/quickstart)
* [SDK reference](/docs/sdk-v2/sdk-reference)
* [Run tools across a CSV](/docs/sdk-v2/batch-csv)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.