Sign in

v1

latestOpenAPI 3.0.1Apache 2.02026-07-1398228598.3 KB
Field Configuration

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).

post/field-configurations/{id}/items

Path parameters

idstring required

UUID of the field configuration.

Request body

titlestring required

Short human-readable title of the item. Trimmed; 1-128 characters.

category'CRM' | 'Indicators' | 'BuiltInInsight' | 'CustomInsight' required

Category of the item.

contentsstring required

Prompt text that Attention will evaluate against each conversation.

descriptionstring

Optional longer description. 0-2000 characters.

promptTypestring required

Prompt family used to analyze the conversation.

contentTypestring required

Expected shape of the extracted content.

responseTypestring

Optional response data type hint.

optionsstring[]

Optional allowed response values for multiple-choice items.

dependsOnstring[]

UUIDs of other items this item depends on.

maxValuesinteger nullable

Maximum number of values allowed for multi-select items.

allowLongResponseboolean

Whether the analyzer may produce a longer free-text response.

extractQuotesboolean

Whether the analyzer should attach supporting quotes to the response.

analysisLevel'conversation' | 'deal' | 'lead' | 'contact' | 'account'

Level at which the item is evaluated.

displayOrderinteger nullable

Optional starting position in the team's ordered item list; existing assignments at or after this position are shifted by one.

requestStageinteger

Optional analysis stage in which the resulting assignments are evaluated.

Example request

{
  "title": "Budget Range",
  "category": "CRM",
  "contents": "What is the customer's stated budget range?",
  "promptType": "freeform",
  "contentType": "text",
  "analysisLevel": "conversation"
}

Response

Item created successfully. The response body contains the new item and the fan-out assignment rows.

Example response

{
  "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
      }
    ]
  }
}