---
title: "Update Field Configuration Item"
method: PATCH
path: "/field-configurations/{id}/items/{itemId}"
tags: ["Field Configuration"]
---

# Update Field Configuration Item

`PATCH /field-configurations/{id}/items/{itemId}`

Partially updates a field-configuration item (PATCH semantics). Items belonging to a field configuration in another organization return 404.

## Path parameters

- `id` string, required
- `itemId` string, required

## Request body

- UpdateFieldConfigurationItemRequest — Request payload for updating an existing field-configuration item. Uses PATCH semantics - only fields present in the body are updated.
  - `title` string — New title. Trimmed; 1-128 characters.
  - `contents` string — New prompt text.
  - `description` string — Optional new description. 0-2000 characters.
  - `promptType` string — New prompt family.
  - `contentType` string — New content type hint.
  - `responseType` string — New response type hint.
  - `options` string[] — New allowed response values.
  - `dependsOn` string[] — New dependency list.
  - `maxValues` integer, nullable — New maximum number of values for multi-select items.
  - `allowLongResponse` boolean, nullable — Whether the analyzer may produce a longer free-text response.
  - `extractQuotes` boolean, nullable — Whether the analyzer should attach supporting quotes.
  - `analysisLevel` 'conversation' | 'deal' | 'lead' | 'contact' | 'account' — New analysis level.
  - `metadata` FieldConfigurationItemMetadata — 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`.
    - `min_score` number, double — Minimum allowed score value.
    - `max_score` number, double — Maximum allowed score value.
    - `middle_score` number, double, nullable — Optional midpoint score value, used by scoring heuristics.
    - `min_criteria` string — Human-readable description of what the minimum score means.
    - `max_criteria` string — Human-readable description of what the maximum score means.
    - `middle_criteria` string, nullable — Human-readable description of what the middle score means.

## Response `200`

Item successfully updated.

- FieldConfigurationItemResponse — Envelope containing a single field-configuration item.
  - `data` FieldConfigurationItem — 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`.
    - `uuid` string, required — Unique identifier of the item.
    - `fieldConfigurationUUID` string, required — UUID of the parent field configuration.
    - `title` string, required — Short human-readable title of the item. Trimmed; 1-128 characters.
    - `category` 'CRM' | 'Indicators' | 'BuiltInInsight' | 'CustomInsight', required — Category of the item. One of the intelligence-category enum values.
    - `contents` string, required — Prompt text that Attention will evaluate against each conversation.
    - `description` string — Optional longer description shown to end users. 0-2000 characters.
    - `promptType` string, required — Prompt family used to analyze the conversation.
    - `contentType` string, required — Expected shape of the extracted content.
    - `responseType` string — Optional response data type hint.
    - `options` string[] — Optional allowed response values when the item is a multiple-choice field.
    - `dependsOn` string[] — UUIDs of other items this item depends on.
    - `maxValues` integer — Maximum number of values allowed for multi-select items.
    - `allowLongResponse` boolean, required — Whether the analyzer may produce a longer free-text response.
    - `extractQuotes` boolean, required — Whether the analyzer should attach supporting quotes to the response.
    - `availableToAllClients` boolean, required — Internal flag marking the item as globally available.
    - `analysisLevel` 'conversation' | 'deal' | 'lead' | 'contact' | 'account' — Level at which the item is evaluated.
    - `metadata` FieldConfigurationItemMetadata — 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`.
      - `min_score` number, double — Minimum allowed score value.
      - `max_score` number, double — Maximum allowed score value.
      - `middle_score` number, double, nullable — Optional midpoint score value, used by scoring heuristics.
      - `min_criteria` string — Human-readable description of what the minimum score means.
      - `max_criteria` string — Human-readable description of what the maximum score means.
      - `middle_criteria` string, nullable — Human-readable description of what the middle score means.
    - `createdAt` string, date-time, required — Timestamp when the item was created.
    - `lastModifiedAt` string, date-time, required — Timestamp when the item was last updated.

## Other responses

- `400` — Invalid body parameters or nothing mutable supplied.
- `401` — Authentication failed. Please provide a valid API key.
- `404` — No item with the provided UUID exists in the specified field configuration.
- `409` — Another item with the same title already exists in this field configuration.
- `422` — Schema-level validation failure on the request body (e.g. value outside the allowed length range).
- `default` — Unexpected error.

---

[API](https://skmtc.net/attention/apis/attention-service-v2.md) · [All operations](https://skmtc.net/attention/apis/attention-service-v2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/attention/attention-service-v2/revisions/5de55d3804cf/schema)