> ## 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 Update Field Configuration Item: Inputs, Cost &
> Update Field Configuration Item. Includes inputs, outputs, pricing notes, Deepline CLI examples, and GTM automation guidance.
## Run in Enrichment Spreadsheet
Use this function as a column step in `deepline enrich`.
```bash theme={null}
deepline enrich --input leads.csv --output leads.enriched.csv --with 'result=attention_update_field_configuration_item:{"id":"{{id}}","itemId":"{{itemId}}"}' --json
```
Map payload values to spreadsheet columns with `{{column_name}}` placeholders.
## Input Schema
| Name | Type | Required | Default | Description |
| --------------------------- | -------------------------------------------------------------- | -------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `payload.id` | `string` | Yes | | UUID of the field configuration. |
| `payload.itemId` | `string` | Yes | | UUID of the field-configuration item. |
| `payload.title` | `string` | No | | New title. Trimmed; 1-128 characters. |
| `payload.contents` | `string` | No | | New prompt text. |
| `payload.description` | `string` | No | | Optional new description. 0-2000 characters. |
| `payload.promptType` | `string` | No | | New prompt family. |
| `payload.contentType` | `string` | No | | New content type hint. |
| `payload.responseType` | `string` | No | | New response type hint. |
| `payload.options` | `array` | No | | New allowed response values. |
| `payload.dependsOn` | `array` | No | | New dependency list. |
| `payload.maxValues` | `integer` | No | | New maximum number of values 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. |
| `payload.analysisLevel` | `"conversation" \| "deal" \| "lead" \| "contact" \| "account"` | No | | New analysis level. |
| `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`. |
### Allowed values
| Field | Allowed values |
| ----------------------- | ---------------------------------------------------- |
| `payload.analysisLevel` | `conversation`, `deal`, `lead`, `contact`, `account` |
Show raw input schema
### Input JSON Schema
```json theme={null}
{
"type": "object",
"description": "Request payload for updating an existing field-configuration item. Uses PATCH semantics - only fields present in the body are updated.",
"properties": {
"id": {
"type": "string",
"description": "UUID of the field configuration."
},
"itemId": {
"type": "string",
"description": "UUID of the field-configuration item."
},
"title": {
"type": "string",
"description": "New title. Trimmed; 1-128 characters."
},
"contents": {
"type": "string",
"description": "New prompt text."
},
"description": {
"type": "string",
"description": "Optional new description. 0-2000 characters."
},
"promptType": {
"type": "string",
"description": "New prompt family."
},
"contentType": {
"type": "string",
"description": "New content type hint."
},
"responseType": {
"type": "string",
"description": "New response type hint."
},
"options": {
"type": "array",
"description": "New allowed response values.",
"items": {
"type": "string"
}
},
"dependsOn": {
"type": "array",
"description": "New dependency list.",
"items": {
"type": "string"
}
},
"maxValues": {
"type": [
"integer",
"null"
],
"description": "New maximum number of values for multi-select items."
},
"allowLongResponse": {
"type": [
"boolean",
"null"
],
"description": "Whether the analyzer may produce a longer free-text response."
},
"extractQuotes": {
"type": [
"boolean",
"null"
],
"description": "Whether the analyzer should attach supporting quotes."
},
"analysisLevel": {
"type": "string",
"description": "New analysis level.",
"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
}
},
"required": [
"id",
"itemId"
],
"additionalProperties": false
}
```
## Output Schema
| Name | Type | Required | Default | Description |
| ------------- | -------- | -------- | ------- | ------------------------------------------------------ |
| `result.data` | `object` | Yes | | Envelope containing a single field-configuration item. |
| `result.meta` | `object` | No | | Additional response metadata (status, paging). |
Show raw output schema
### Output JSON Schema
```json theme={null}
{
"type": "object",
"description": "Standard tool result payload.",
"properties": {
"data": {
"type": "object",
"description": "Envelope containing a single field-configuration item.",
"properties": {
"data": {
"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
}
},
"additionalProperties": false
},
"meta": {
"type": "object",
"description": "Additional response metadata (status, paging).",
"additionalProperties": true
}
},
"required": [
"data"
],
"additionalProperties": false
}
```
## Advanced: Direct CLI
Use direct execution for single payload debugging.
```bash theme={null}
deepline tools execute attention_update_field_configuration_item --payload '{
"id": "string",
"itemId": "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`.