Skip to main content
POST
Create Scorecard Item

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:

Response

Scorecard item successfully created

Single-resource envelope wrapping a ScorecardItem.

data
object
required

A single scoring criterion belonging to a scorecard template.

Example: