v1

latestOpenAPI 3.0.1Apache 2.02026-07-1398228598.3 KB

Scorecard

Update Scorecard Item

Partially updates a scorecard item. Only fields present in the body are modified; omitted fields retain current values. Requires an org-scoped API key.

patch/scorecards/{id}/items/{itemId}

Path parameters

idstring required

Parent scorecard UUID

itemIdstring required

Scorecard item UUID

Request body

titlestring

Replacement title (1-128 characters, trimmed).

weightinteger

Replacement weight (0-100).

positioninteger

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

expertPromptstring

Replacement expert-mode prompt (0-8000 characters).

Example request

{
  "title": "Discovery Quality (revised)",
  "weight": 30
}

Response

Scorecard item successfully updated

Example response

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