> ## Documentation Index > Fetch the complete documentation index at: https://docs.attention.com/llms.txt > Use this file to discover all available pages before exploring further. # Create Field Configuration Item > 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). ## OpenAPI ````yaml post /field-configurations/{id}/items openapi: 3.0.1 info: title: Attention Service V2 description: Attention Service API V2 termsOfService: https://www.attention.com/terms-of-use contact: name: Attention Team url: https://docs.attention.com/welcome email: support@attention.com license: name: Apache 2.0 url: https://www.apache.org/licenses/LICENSE-2.0.html version: 1.8.0 servers: - url: https://api.attention.tech/v2 security: - APIKeyHeader: [] paths: /field-configurations/{id}/items: post: tags: - Field Configuration summary: Create Field Configuration Item description: >- 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). operationId: createFieldConfigurationItem parameters: - name: id in: path description: UUID of the field configuration. required: true schema: type: string requestBody: description: Item to create inside the field configuration. content: application/json: schema: $ref: '#/components/schemas/CreateFieldConfigurationItemRequest' application/vnd.api+json: schema: $ref: '#/components/schemas/CreateFieldConfigurationItemRequest' required: true responses: '201': description: >- Item created successfully. The response body contains the new item and the fan-out assignment rows. content: application/json: schema: $ref: '#/components/schemas/FieldConfigurationItemCreateResponse' application/vnd.api+json: schema: $ref: '#/components/schemas/FieldConfigurationItemCreateResponse' '400': description: Invalid or missing fields on the request body. content: application/json: schema: $ref: '#/components/schemas/Error' application/vnd.api+json: schema: $ref: '#/components/schemas/Error' '401': description: Authentication failed. Please provide a valid API key. content: application/json: schema: $ref: '#/components/schemas/Error' application/vnd.api+json: schema: $ref: '#/components/schemas/Error' '404': description: >- No field configuration with the provided UUID exists in the organization. content: application/json: schema: $ref: '#/components/schemas/Error' application/vnd.api+json: schema: $ref: '#/components/schemas/Error' '409': description: >- An item with the same title already exists in this field configuration. content: application/json: schema: $ref: '#/components/schemas/Error' application/vnd.api+json: schema: $ref: '#/components/schemas/Error' '422': description: >- Schema-level validation failure on the request body (e.g. required field missing or value outside the allowed length range). content: application/json: schema: $ref: '#/components/schemas/Error' application/vnd.api+json: schema: $ref: '#/components/schemas/Error' default: description: Unexpected error. content: application/json: schema: $ref: '#/components/schemas/Error' application/vnd.api+json: schema: $ref: '#/components/schemas/Error' components: schemas: CreateFieldConfigurationItemRequest: required: - category - contentType - contents - promptType - title type: object properties: title: type: string description: Short human-readable title of the item. Trimmed; 1-128 characters. example: Budget Range category: type: string description: Category of the item. example: CRM enum: - CRM - Indicators - BuiltInInsight - CustomInsight contents: type: string description: Prompt text that Attention will evaluate against each conversation. example: What is the customer's stated budget range? description: type: string description: Optional longer description. 0-2000 characters. example: Used by the RevOps team to forecast deal size. promptType: type: string description: Prompt family used to analyze the conversation. example: freeform contentType: type: string description: Expected shape of the extracted content. example: text responseType: type: string description: Optional response data type hint. example: number options: type: array description: Optional allowed response values for multiple-choice items. example: - small - medium - large 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. nullable: true example: 1 allowLongResponse: type: boolean description: Whether the analyzer may produce a longer free-text response. example: false extractQuotes: type: boolean description: >- Whether the analyzer should attach supporting quotes to the response. example: true analysisLevel: type: string description: Level at which the item is evaluated. example: conversation enum: - conversation - deal - lead - contact - account metadata: $ref: '#/components/schemas/FieldConfigurationItemMetadata' displayOrder: type: integer description: >- Optional starting position in the team's ordered item list; existing assignments at or after this position are shifted by one. nullable: true example: 0 requestStage: type: integer description: >- Optional analysis stage in which the resulting assignments are evaluated. example: 0 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. example: title: Budget Range category: CRM contents: What is the customer's stated budget range? promptType: freeform contentType: text analysisLevel: conversation FieldConfigurationItemCreateResponse: type: object properties: data: $ref: '#/components/schemas/FieldConfigurationItemCreateData' 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). example: data: item: uuid: b9e1c0a0-5a3d-4a9c-9b1e-2d6f4b7a1c11__item-01 fieldConfigurationUUID: b9e1c0a0-5a3d-4a9c-9b1e-2d6f4b7a1c11 title: Budget Range category: CRM contents: What is the customer's stated budget range? promptType: freeform contentType: text assignments: - uuid: b9e1c0a0-5a3d-4a9c-9b1e-2d6f4b7a1c11__item-01-a1b2c3 intelligenceItemUUID: b9e1c0a0-5a3d-4a9c-9b1e-2d6f4b7a1c11__item-01 teamUUID: fe515723-fe2e-4959-a5fa-c4d3937fe7e4 category: CRM displayOrder: 0 Error: type: object properties: id: type: string description: A unique identifier for the error. status: type: string description: >- The HTTP status code applicable to this problem, expressed as a string value. code: type: string description: An application-specific error code, expressed as a string value. title: type: string description: A short, human-readable summary of the problem. detail: type: string description: >- A human-readable explanation specific to this occurrence of the problem. source: type: object properties: pointer: type: string parameter: type: string meta: type: object properties: {} example: id: not_found_error status: '404' code: '404' title: Not Found Error detail: The requested resource was not found source: pointer: /data/attributes/id FieldConfigurationItemMetadata: type: object properties: min_score: type: number description: Minimum allowed score value. format: double example: 0 max_score: type: number description: Maximum allowed score value. format: double example: 10 middle_score: type: number description: Optional midpoint score value, used by scoring heuristics. format: double nullable: true example: 5 min_criteria: type: string description: Human-readable description of what the minimum score means. example: No fit max_criteria: type: string description: Human-readable description of what the maximum score means. example: Perfect fit middle_criteria: type: string description: Human-readable description of what the middle score means. nullable: true example: Partial fit 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`. example: min_score: 0 max_score: 10 min_criteria: No fit max_criteria: Perfect fit FieldConfigurationItemCreateData: type: object properties: item: $ref: '#/components/schemas/FieldConfigurationItem' 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: $ref: '#/components/schemas/IntelligenceItemAssignment' description: >- Create-item payload: the newly created item plus the fan-out `IntelligenceItemAssignment` rows - one per team the parent field configuration is assigned to. example: item: uuid: b9e1c0a0-5a3d-4a9c-9b1e-2d6f4b7a1c11__item-01 fieldConfigurationUUID: b9e1c0a0-5a3d-4a9c-9b1e-2d6f4b7a1c11 title: Budget Range category: CRM contents: What is the customer's stated budget range? promptType: freeform contentType: text assignments: - uuid: b9e1c0a0-5a3d-4a9c-9b1e-2d6f4b7a1c11__item-01-a1b2c3 intelligenceItemUUID: b9e1c0a0-5a3d-4a9c-9b1e-2d6f4b7a1c11__item-01 teamUUID: fe515723-fe2e-4959-a5fa-c4d3937fe7e4 category: CRM displayOrder: 0 FieldConfigurationItem: required: - allowLongResponse - availableToAllClients - category - contentType - contents - createdAt - extractQuotes - fieldConfigurationUUID - lastModifiedAt - promptType - title - uuid type: object properties: uuid: type: string description: Unique identifier of the item. example: b9e1c0a0-5a3d-4a9c-9b1e-2d6f4b7a1c11__item-01 fieldConfigurationUUID: type: string description: UUID of the parent field configuration. example: b9e1c0a0-5a3d-4a9c-9b1e-2d6f4b7a1c11 title: type: string description: Short human-readable title of the item. Trimmed; 1-128 characters. example: Budget Range category: type: string description: Category of the item. One of the intelligence-category enum values. example: CRM enum: - CRM - Indicators - BuiltInInsight - CustomInsight contents: type: string description: Prompt text that Attention will evaluate against each conversation. example: What is the customer's stated budget range? description: type: string description: Optional longer description shown to end users. 0-2000 characters. example: Used by the RevOps team to forecast deal size. promptType: type: string description: Prompt family used to analyze the conversation. example: freeform contentType: type: string description: Expected shape of the extracted content. example: text responseType: type: string description: Optional response data type hint. example: number options: type: array description: >- Optional allowed response values when the item is a multiple-choice field. example: - small - medium - large 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. example: 1 allowLongResponse: type: boolean description: Whether the analyzer may produce a longer free-text response. example: false extractQuotes: type: boolean description: >- Whether the analyzer should attach supporting quotes to the response. example: true availableToAllClients: type: boolean description: Internal flag marking the item as globally available. example: false analysisLevel: type: string description: Level at which the item is evaluated. example: conversation enum: - conversation - deal - lead - contact - account metadata: $ref: '#/components/schemas/FieldConfigurationItemMetadata' createdAt: type: string description: Timestamp when the item was created. format: date-time example: '2026-03-01T12:00:00Z' lastModifiedAt: type: string description: Timestamp when the item was last updated. format: date-time example: '2026-03-02T08:30:00Z' 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`. example: uuid: b9e1c0a0-5a3d-4a9c-9b1e-2d6f4b7a1c11__item-01 fieldConfigurationUUID: b9e1c0a0-5a3d-4a9c-9b1e-2d6f4b7a1c11 title: Budget Range category: CRM contents: What is the customer's stated budget range? promptType: freeform contentType: text analysisLevel: conversation createdAt: '2026-03-01T12:00:00Z' lastModifiedAt: '2026-03-02T08:30:00Z' IntelligenceItemAssignment: required: - category - createdAt - intelligenceItemUUID - lastModifiedAt - teamUUID - uuid type: object properties: uuid: type: string description: Unique identifier of the assignment row. example: b9e1c0a0-5a3d-4a9c-9b1e-2d6f4b7a1c11__item-01-a1b2c3 intelligenceItemUUID: type: string description: >- UUID of the underlying field-configuration item this assignment points at. example: b9e1c0a0-5a3d-4a9c-9b1e-2d6f4b7a1c11__item-01 teamUUID: type: string description: UUID of the team this assignment applies to. example: fe515723-fe2e-4959-a5fa-c4d3937fe7e4 organizationUUID: type: string description: UUID of the organization this assignment belongs to. example: 16b78cec-82ef-46d2-8213-5d3bb7d2571c category: type: string description: >- Category of the underlying item (copied from the item at assignment time). example: CRM displayOrder: type: integer description: Position of this assignment in the team's ordered list of items. example: 0 requestStage: type: integer description: Analysis stage in which this assignment is evaluated. example: 0 createdAt: type: string description: Timestamp when the assignment was created. format: date-time example: '2026-03-01T12:00:00Z' lastModifiedAt: type: string description: Timestamp when the assignment was last updated. format: date-time example: '2026-03-01T12:00:00Z' 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. example: uuid: b9e1c0a0-5a3d-4a9c-9b1e-2d6f4b7a1c11__item-01-a1b2c3 intelligenceItemUUID: b9e1c0a0-5a3d-4a9c-9b1e-2d6f4b7a1c11__item-01 teamUUID: fe515723-fe2e-4959-a5fa-c4d3937fe7e4 organizationUUID: 16b78cec-82ef-46d2-8213-5d3bb7d2571c category: CRM displayOrder: 0 requestStage: 0 securitySchemes: APIKeyHeader: type: apiKey name: Authorization in: header ````