Skip to main content
DELETE
Remove 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 still pin the label fail with preset_version_not_found until you add it again.

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

Response

Label removed

deleted
boolean
required
label
string
required
Last modified on October 27, 2026