Skip to main content
POST
/
scorecards
/
{id}
/
items
Create Scorecard Item
curl --request POST \
  --url https://api.attention.tech/v2/scorecards/{id}/items \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "title": "Discovery Quality",
  "type": "numeric",
  "weight": 25,
  "metadata": {
    "numericMetadata": {
      "min": 0,
      "middle": 50,
      "max": 100,
      "minCriteria": "No discovery questions asked.",
      "middleCriteria": "Some discovery questions asked.",
      "maxCriteria": "Thorough discovery performed."
    }
  }
}
'
{
  "data": {
    "id": "si-uuid-123",
    "scorecardId": "sc-uuid-456",
    "title": "Discovery Quality",
    "type": "numeric",
    "position": 0,
    "weight": 25,
    "version": 1,
    "createdAt": "2026-04-16T10:15:00Z",
    "lastUpdatedAt": "2026-04-16T10:15:00Z"
  }
}

Authorizations

​
Authorization
string
header
required

Path Parameters

​
id
string
required

Parent scorecard UUID

Body

Scorecard item creation payload

Payload for creating a single scorecard item.

​
title
string
required

Human-readable title of the item (1-128 characters, trimmed).

​
type
enum<string>
required

Scoring type for a scorecard item. Currently only numeric is supported.

Available options:
numeric
Example:

"numeric"

​
weight
integer
required

Relative weight of this item within the scorecard (0-100).

​
position
integer

Optional position override. When omitted, the item is appended to the end of the scorecard.

​
expertPrompt
string

Optional expert-mode prompt override (0-8000 characters).

​
metadata
object

Type-discriminated metadata for a scorecard item. Numeric items populate numericMetadata.

Example:
{
  "numericMetadata": {
    "min": 0,
    "middle": 50,
    "max": 100,
    "minCriteria": "No discovery questions asked.",
    "middleCriteria": "Some discovery questions asked.",
    "maxCriteria": "Thorough discovery performed."
  }
}

Response

Scorecard item successfully created

Single-resource envelope wrapping a ScorecardItem.

​
data
object
required

A single scoring criterion belonging to a scorecard template.

Example:
{
  "id": "si-uuid-123",
  "scorecardId": "sc-uuid-456",
  "title": "Discovery Quality",
  "type": "numeric",
  "position": 0,
  "weight": 25,
  "version": 1,
  "expertPrompt": "",
  "metadata": {
    "numericMetadata": {
      "min": 0,
      "middle": 50,
      "max": 100,
      "minCriteria": "No discovery questions asked.",
      "middleCriteria": "Some discovery questions asked.",
      "maxCriteria": "Thorough discovery performed."
    }
  },
  "createdAt": "2026-04-16T10:15:00Z",
  "lastUpdatedAt": "2026-04-16T10:15:00Z"
}