Skip to main content
POST
/
field-configurations
/
{id}
/
items
Create Field Configuration Item
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
{
  "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

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.

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

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.

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