Skip to main content
PUT
Set a preset label
This endpoint requires a management API key with presets:write and an associated user identity. The preset’s creator can change its labels, and so can workspace owners and admins when the preset is shared.
Requests that pin the label, such as @support-triage@production or prompt.version: "production", use the new version within about two minutes. See Versions and labels.

Authorizations

Authorization
string
header
required

Bearer token authentication

Path Parameters

id
string
required

Preset UUID, slug, or canonical name.

label
string
required

Label name, such as production. 1 to 32 lowercase letters, numbers, hyphens or underscores, starting with a letter; it cannot look like a version label (v1, v2).

Pattern: ^[a-z][a-z0-9_-]{0,31}$

Body

application/json

Send exactly one of version_id and version.

version_id
string<uuid>

The published version to point the label at.

version
string

A version label such as v3, 1.2.0 or 2026.10.27, or another label such as staging to copy where it points.

Maximum string length: 64

Response

Label saved

data
object
required
Last modified on October 27, 2026