Sign in

v1

latestOpenAPI 3.0.1Apache 2.02026-07-1398228598.3 KB
Scorecard

Create Scorecard Item

Adds a single item (scoring criterion) to the given scorecard. The new item is appended at the next position. Requires an org-scoped API key.

post/scorecards/{id}/items

Path parameters

idstring required

Parent scorecard UUID

Request body

titlestring required

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

type'numeric' required

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

weightinteger required

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

positioninteger

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

expertPromptstring

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

Example request

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

Response

Scorecard item successfully created

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