Delete Tag

Permanent, and only while the tag is unused — 409 lists how many creatives still carry it. There is no cascade and no restore: a tag that has been used is retired with archived, which keeps every creative that carries it findable.

DELETE/api/v1/tags/{slug}

Authorization

AuthorizationBearer token · headerrequired

AuthorizationOAuth2 access token · headerrequired

Path parameters

slugstringrequired

min length 1 · max length 32

Responses

200Successful Response

successboolean

default: true

dataany

messagestring | any

Show properties

Any of:

string

string

any

any

errorsstring[] | any

Show properties

Any of:

string[]

Array of string

string

any

any

422Validation Error

detailValidationError[]

Show properties

Array of ValidationError

locstring | integer[]required

Show properties

Array of string | integer

Any of:

string

string

integer

integer

msgstringrequired

typestringrequired

inputany

ctxobject

Request

curl -X DELETE "/api/v1/tags/string" \
  -H "Authorization: Bearer YOUR_TOKEN"

const response = await fetch("/api/v1/tags/string", {
  method: "DELETE",
  headers: {
    "Authorization": "Bearer YOUR_TOKEN"
  }
});

import requests

response = requests.delete(
    "/api/v1/tags/string",
    headers={
        "Authorization": "Bearer YOUR_TOKEN"
    },
)

Response

{
  "success": true,
  "data": null,
  "message": "string",
  "errors": [
    "string"
  ]
}