Bulk-delete tags

Delete multiple tags in one request: `{ tagIds: [...] }`, or `{ deleteAll: true }` to wipe every tag the user owns. **Requires `Idempotency-Key`** (the `deleteAll` arm is never safe to blindly re-exec

POST /v2/tags/batch-delete

Parameters

Header parameters

Idempotency-Key

string required

Required. UUID per logical operation, reused on every retry. See apps/rest-api/src/shared/idempotency.ts for the full contract. Missing → 400 BadRequest; same key + different body → 409 Conflict.

Request body

Content-Type: application/json

tagIds

array<string (uuid)>

deleteAll

boolean

Example

{
  "tagIds": [
    "00000000-0000-0000-0000-000000000000"
  ],
  "deleteAll": false
}

Responses

200 — Successful response

Content-Type: application/json

data

object required

data.affected

integer required

data.ids

array<string>

data.failed

array<object>

data.failed[].id

string

data.failed[].error

object

data.failed[].error.code

string

data.failed[].error.message

string

Example

{
  "data": {
    "affected": 0
  }
}

400

No response body.

401

No response body.

403

No response body.

404

No response body.

409

No response body.

429

No response body.

500

No response body.

Code samples

curl https://api.prod.getdex.com/v2/tags/batch-delete \
  --request POST \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
  "tagIds": [
    "00000000-0000-0000-0000-000000000000"
  ],
  "deleteAll": false
}'

fetch('https://api.prod.getdex.com/v2/tags/batch-delete', {
  method: 'POST',
  headers: {
    Authorization: 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    tagIds: ['00000000-0000-0000-0000-000000000000'],
    deleteAll: false
  })
})

requests.post(
    "https://api.prod.getdex.com/v2/tags/batch-delete",
    headers={
      "Authorization": "Bearer YOUR_API_KEY",
      "Content-Type": "application/json"
    },
    json={
      "tagIds": [
        "00000000-0000-0000-0000-000000000000"
      ],
      "deleteAll": False
    }
)

Bulk-create tags

Create multiple tags from a `{ names: [...] }` array. Names are deduplicated; existing tags with the same name are returned rather than duplicated. **Requires `Idempotency-Key`.** Returns `{ data: { t

Assign tags to contacts

Assign a set of existing tags to a set of contacts (the cartesian product). Body: `{ contactIds: [...], tagIds: [...] }`. **Requires `Idempotency-Key`.** Returns the bulk envelope `{ data: { affected