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

Create Field Configuration Item

cURL

curl --request POST \
  --url https://api.attention.tech/v2/field-configurations/{id}/items \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data @- <<EOF
{
  "title": "Budget Range",
  "category": "CRM",
  "contents": "What is the customer's stated budget range?",
  "promptType": "freeform",
  "contentType": "text",
  "analysisLevel": "conversation"
}
EOF

201

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

Authorizations

Authorization · string · header · required

Path Parameters

id · string · required

UUID of the field configuration.

Body

application/jsonapplication/vnd.api+json

Item to create inside the field configuration.

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.

Example:

"Budget Range"

category · enum<string> · required

Category of the item.

Available options: CRM, Indicators, BuiltInInsight, CustomInsight

Example:

"CRM"

contents · string · required

Prompt text that Attention will evaluate against each conversation.

Example:

"What is the customer's stated budget range?"

promptType · string · required

Prompt family used to analyze the conversation.

Example:

"freeform"

contentType · string · required

Expected shape of the extracted content.

Example:

"text"

description · string

Optional longer description. 0-2000 characters.

Example:

"Used by the RevOps team to forecast deal size."

responseType · string

Optional response data type hint.

Example:

"number"

options · string[]

Optional allowed response values for multiple-choice items.

Example:

["small", "medium", "large"]

dependsOn · string[]

UUIDs of other items this item depends on.

maxValues · integer | null

Maximum number of values allowed for multi-select items.

Example:

1

allowLongResponse · boolean

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

Example:

false

extractQuotes · boolean

Whether the analyzer should attach supporting quotes to the response.

Example:

true

analysisLevel · enum<string>

Level at which the item is evaluated.

Available options: conversation, deal, lead, contact, account

Example:

"conversation"

metadata · object

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.

Show child attributes

Example:

{
  "min_score": 0,
  "max_score": 10,
  "min_criteria": "No fit",
  "max_criteria": "Perfect fit"
}

displayOrder · integer | null

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

Example:

0

requestStage · integer

Optional analysis stage in which the resulting assignments are evaluated.

Example:

0

Response

201

application/json

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

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 · object

Create-item payload: the newly created item plus the fan-out IntelligenceItemAssignment rows - one per team the parent field configuration is assigned to.

Show child attributes

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