> ## 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

> Change a field in an Attention field configuration, such as its prompt or answer type. Includes inputs, outputs, SDK V2 examples, and Deepline cost.

Change a field in an Attention field configuration, such as its prompt or answer type.

> [!NOTE]
>
> Tool ID: `attention_update_field_configuration_item`

## Run this action

Use the TypeScript SDK for one call. Use `ctx.tools.execute(...)` inside a Play for durable calls, scheduled calls, or CSV processing.

```ts theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
import { Deepline } from 'deepline';

const deepline = await Deepline.connect();
const result = await deepline.tools.execute(
  'attention_update_field_configuration_item',
  {
    "id": "id_123",
    "itemId": "item_123"
  },
);

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

### CLI

```bash theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
deepline tools execute attention_update_field_configuration_item --input '{
  "id": "id_123",
  "itemId": "item_123"
}' --json
```

## Example response

The SDK returns this shape at `result.toolResponse.raw`. The example values illustrate the response.

```json theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
{
  "data": {
    "data": {
      "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"
    }
  }
}
```

Use `deepline describe attention_update_field_configuration_item --json` for the latest machine-readable contract.

## Input reference

Request payload for updating an existing field-configuration item. Uses PATCH semantics - only fields present in the body are updated.

| Name | Type | Required | Default | Details |
| - | - | - | - | - |
| `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. 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`. |

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

  ### Input JSON Schema

  ```json theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
  {
    "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
  }
  ```
</details>

## Output reference

Standard tool result payload.

| Name | Type | Required | Default | Details |
| - | - | - | - | - |
| `result.data` | `object` | Yes | — | Envelope containing a single field-configuration item. |
| `result.data.data` | `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.uuid` | `string` | Yes | — | Unique identifier of the item. |
| `result.data.data.fieldConfigurationUUID` | `string` | Yes | — | UUID of the parent field configuration. |
| `result.data.data.title` | `string` | Yes | — | Short human-readable title of the item. Trimmed. 1-128 characters. |
| `result.data.data.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.contents` | `string` | Yes | — | Prompt text that Attention will evaluate against each conversation. |
| `result.data.data.description` | `string` | No | — | Optional longer description shown to end users. 0-2000 characters. |
| `result.data.data.promptType` | `string` | Yes | — | Prompt family used to analyze the conversation. |
| `result.data.data.contentType` | `string` | Yes | — | Expected shape of the extracted content. |
| `result.data.data.responseType` | `string` | No | — | Optional response data type hint. |
| `result.data.data.options` | `array` | No | — | Optional allowed response values when the item is a multiple-choice field. |
| `result.data.data.dependsOn` | `array` | No | — | UUIDs of other items this item depends on. |
| `result.data.data.maxValues` | `integer` | No | — | Maximum number of values allowed for multi-select items. |
| `result.data.data.allowLongResponse` | `boolean` | Yes | — | Whether the analyzer may produce a longer free-text response. |
| `result.data.data.extractQuotes` | `boolean` | Yes | — | Whether the analyzer should attach supporting quotes to the response. |
| `result.data.data.availableToAllClients` | `boolean` | Yes | — | Internal flag marking the item as globally available. |
| `result.data.data.analysisLevel` | `"conversation" \| "deal" \| "lead" \| "contact" \| "account"` | No | — | Level at which the item is evaluated. Allowed: `conversation`, `deal`, `lead`, `contact`, `account`. |
| `result.data.data.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.metadata.min_score` | `number` | No | — | Minimum allowed score value. Format: `double`. |
| `result.data.data.metadata.max_score` | `number` | No | — | Maximum allowed score value. Format: `double`. |
| `result.data.data.metadata.middle_score` | `number \| null` | No | — | Optional midpoint score value, used by scoring heuristics. Format: `double`. |
| `result.data.data.metadata.min_criteria` | `string` | No | — | Human-readable description of what the minimum score means. |
| `result.data.data.metadata.max_criteria` | `string` | No | — | Human-readable description of what the maximum score means. |
| `result.data.data.metadata.middle_criteria` | `string \| null` | No | — | Human-readable description of what the middle score means. |
| `result.data.data.createdAt` | `string` | Yes | — | Timestamp when the item was created. Format: `date-time`. |
| `result.data.data.lastModifiedAt` | `string` | Yes | — | Timestamp when the item 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={"languages":{"custom":["/languages/deepline-prompt.json"]}}
  {
    "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
  }
  ```
</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](https://deepline.com/docs/providers/attention/guide.md)
* [SDK V2 quickstart](https://deepline.com/docs/sdk-v2/quickstart.md)
* [SDK reference](https://deepline.com/docs/sdk-v2/sdk-reference.md)
* [Run tools across a CSV](https://deepline.com/docs/sdk-v2/batch-csv.md)


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