Delete a tag

Permanently delete a tag by its ID. The tag is removed from all contacts it was assigned to.

DELETE /v1/tags/{tagId}

Parameters

Path parameters

tagId

string (uuid) required

Responses

200 — Successful response

Content-Type: application/json

error

boolean required

Example

{
  "error": false
}

400 — Request body failed validation.

Content-Type: application/json

(body)

any

401 — Missing or invalid API key.

Content-Type: application/json

(body)

any

403 — Valid key, insufficient permission.

Content-Type: application/json

(body)

any

404 — Resource does not exist.

Content-Type: application/json

(body)

any

409 — Request conflicts with the current state of the resource.

Content-Type: application/json

(body)

any

429 — Rate limit exceeded.

Content-Type: application/json

(body)

any

500 — Unexpected server error.

Content-Type: application/json

(body)

any

Code samples

curl https://api.prod.getdex.com/v1/tags/00000000-0000-0000-0000-000000000000 \
  --request DELETE \
  --header 'Authorization: Bearer YOUR_API_KEY'

fetch('https://api.prod.getdex.com/v1/tags/00000000-0000-0000-0000-000000000000', {
  method: 'DELETE',
  headers: {
    Authorization: 'Bearer YOUR_API_KEY'
  }
})

requests.delete(
    "https://api.prod.getdex.com/v1/tags/00000000-0000-0000-0000-000000000000",
    headers={
      "Authorization": "Bearer YOUR_API_KEY"
    }
)

Update a tag

Update a tag's name or color by its ID. Only the fields included in the request body are modified.

Get contact counts per tag

Retrieve the number of contacts associated with each tag. Returns a map of tag IDs to their respective contact counts.