--- title: "Create Field Configuration Item" method: POST path: "/field-configurations/{id}/items" tags: ["Field Configuration"] --- # Create Field Configuration Item `POST /field-configurations/{id}/items` Creates a single new item inside a field configuration. The REST endpoint wraps the singular request around 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 body includes both the new item and the list of created assignments under `data.assignments` (explicit fan-out). ## Path parameters - `id` string, required ## Request body - CreateFieldConfigurationItemRequest — 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. - `title` string, required — Short human-readable title of the item. Trimmed; 1-128 characters. - `category` 'CRM' | 'Indicators' | 'BuiltInInsight' | 'CustomInsight', required — Category of the item. - `contents` string, required — Prompt text that Attention will evaluate against each conversation. - `description` string — Optional longer description. 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 for multiple-choice items. - `dependsOn` string[] — UUIDs of other items this item depends on. - `maxValues` integer, nullable — Maximum number of values allowed for multi-select items. - `allowLongResponse` boolean — Whether the analyzer may produce a longer free-text response. - `extractQuotes` boolean — Whether the analyzer should attach supporting quotes to the response. - `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. - `displayOrder` integer, nullable — Optional starting position in the team's ordered item list; existing assignments at or after this position are shifted by one. - `requestStage` integer — Optional analysis stage in which the resulting assignments are evaluated. ## Response `201` Item created successfully. The response body contains the new item and the fan-out assignment rows. - FieldConfigurationItemCreateResponse — 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). - `data` FieldConfigurationItemCreateData — Create-item payload: the newly created item plus the fan-out `IntelligenceItemAssignment` rows - one per team the parent field configuration is assigned to. - `item` 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. - `assignments` IntelligenceItemAssignment[] — Assignment rows created as part of the fan-out. For a configuration assigned to N teams, N assignments are returned. - `uuid` string, required — Unique identifier of the assignment row. - `intelligenceItemUUID` string, required — UUID of the underlying field-configuration item this assignment points at. - `teamUUID` string, required — UUID of the team this assignment applies to. - `organizationUUID` string — UUID of the organization this assignment belongs to. - `category` string, required — Category of the underlying item (copied from the item at assignment time). - `displayOrder` integer — Position of this assignment in the team's ordered list of items. - `requestStage` integer — Analysis stage in which this assignment is evaluated. - `createdAt` string, date-time, required — Timestamp when the assignment was created. - `lastModifiedAt` string, date-time, required — Timestamp when the assignment was last updated. ## Other responses - `400` — Invalid or missing fields on the request body. - `401` — Authentication failed. Please provide a valid API key. - `404` — No field configuration with the provided UUID exists in the organization. - `409` — An item with the same title already exists in this field configuration. - `422` — Schema-level validation failure on the request body (e.g. required field missing or 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/versions/5de55d3804cf/schema)