Update Scorecard Item - Attention Docs

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

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.

Show child attributes

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.

Show child attributes

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