Skip to main content
PATCH
/
scorecards
/
{id}
/
items
/
{itemId}
Update Scorecard Item
curl --request PATCH \
  --url https://api.attention.tech/v2/scorecards/{id}/items/{itemId} \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "title": "Discovery Quality (revised)",
  "weight": 30
}
'
{
  "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

​
itemId
string
required

Scorecard item UUID

Body

Fields to update. All fields optional; at least one required.

Partial update payload for a scorecard item. All fields optional; at least one required.

​
title
string

Replacement title (1-128 characters, trimmed).

​
weight
integer

Replacement weight (0-100).

​
position
integer

Replacement position. Reordering siblings is the caller's responsibility; overlapping positions may produce undefined ordering.

​
expertPrompt
string

Replacement expert-mode prompt (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 updated

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