Skip to main content
POST
curl

Authorizations

Authorization
string
header
required

A key generated from Settings → Developers, sent as Authorization: Bearer dr_live_<12 hex chars>_<64 hex chars>. Keys carry explicit scopes — each endpoint states the one it requires. The full key is shown exactly once at generation time and cannot be retrieved again; only the keyId prefix is shown afterward. A revoked key fails auth on its very next request.

Body

application/json
name
string
required

The tag name. After surrounding spaces are removed it must be 1-50 characters and must not contain a NUL character.

Example:

"webinar-oct"

Response

A tag with exactly this name already exists. Nothing was created (created: false) and the existing tag is returned. A retry lands here.

id
string<uuid>
required

The tag id.

name
string
required

The stored name (surrounding spaces removed, NFC-normalized).

created
boolean
required

true if this call created the tag, false if a tag with exactly this name already existed.