Skip to main content
POST
Create a label set

Authorizations

Authorization
string
header
required

Your workspace API key, e.g. sk_sovereign_..., sent as Authorization: Bearer <key>.

Body

application/json
name
string
required

Set name, trimmed, 1..80 chars (400 otherwise).

description
string

Optional description; trimmed and truncated to 500 chars.

request_ids
string[]

Explicit members. Every id must carry a human (non-verifier) grade in this workspace, otherwise 400 naming how many are missing. Deduplicated. Takes precedence over latest when non-empty.

latest
integer

When request_ids is absent/empty: take the newest N human grades. Default 200; clamped to 20..5000.

Response

201 with the set object: { id, name, description, size, membership_hash: null, frozen_at: null, kappa: null, agreement: null, kappa_n: null, rater_count: null, attached_to: [], created_at }. The set is NOT frozen yet.

The response is of type object.