v3

OpenAPI 3.0.0Dex Terms of Service2026-07-311481984.7 KB
tags

Delete a tag (v2)

Permanently delete a tag (its contact assignments cascade). Returns the canonical bulk envelope: { data: { affected: 1, ids: [tagId] } }. Idempotency-Key is optional.

delete/v2/tags/{tagId}

Path parameters

tagIdstring uuid required

Headers

Idempotency-Keystring
Example:01HV8N6X7K3P9Q5R2T4Y6W8Z0A

Optional. Accepted to dedupe retries on this endpoint. See apps/rest-api/src/shared/idempotency.ts.

Response

Successful response