delete label
Delete a custom label using If-Match revision; default labels cannot be deleted.
/api/v1/organizations/{organizationId}/prompts/{promptId}/labels/{labelName}Authorization
ManagementOAuth managementUser-based Clerk OAuth. CLI is a public Authorization Code client using S256 PKCE and browser loopback redirect. Hosted MCP uses resource-bound OAuth. Verify issuer, token type, intended audience/resource, scopes, live membership and current role. Do not forward arbitrary OAuth tokens into Convex session JWT auth. OAuth URLs below are placeholders for deployment configuration.
In: header
Scope: management
Path Parameters
Permanent organizationId; selected organization must be authorized for the current user.
Permanent promptId; selected organization must be authorized for the current user.
Permanent labelName; selected organization must be authorized for the current user.
Header Parameters
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
curl -X DELETE "https://example.com/api/v1/organizations/string/prompts/string/labels/string" \ -H "If-Match: string"rename label PATCH
Rename only a custom label with a matching revision. Default production/staging labels are permanent. The old name subsequently returns label_not_found.
get dataset GET
Uses the selected organization and the authenticated user’s current permissions. Applies the same setup and archive rules as the dashboard.