Delete an attribute definition

Search Documentation

Search across all developer documentation

attributes

Delete an attribute definition

DELETE /v1/attributes/{id}
Auth required api.attributes.manage

Deletes an attribute definition. Deletion is always disruptive: Segments that reference the attribute keep evaluating best-effort but carry a standing eval_warning (their predicate no longer type-checks). The response carries the impact (affected segments + projected org-wide drop-out). Git-backed definitions are read-only here (409 conflict).

Path parameters

id string<uuid> required

Resource UUID. An unparseable id reads as a clean 404 not_found.

Responses

200 The deletion's mutation class (always disruptive) and impact application/json
401 Missing, malformed, or unknown API key application/problem+json
403 Key lacks the required scope or plan limit violated application/problem+json
404 Resource not found application/problem+json
409 The mutation is rejected by a state rule rather than a bad request — e.g. editing a git-backed (read-only) definition. The code is conflict. application/problem+json
429 Per-org rate limit exceeded application/problem+json
500 Unexpected server-side failure. The code is internal_error. The request_id field can be quoted to SendOps support to investigate. application/problem+json