Tags_delete

DELETE

/tags/{id}

const url = 'http://localhost:3000/api/tags/example';
const options = {method: 'DELETE', headers: {Authorization: 'Bearer <token>'}};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request DELETE \
  --url http://localhost:3000/api/tags/example \
  --header 'Authorization: Bearer <token>'

Delete a tag from the catalogue, unless a segment rule or an automation step names it. The 409 names the users.

Authorizations

BearerAuth

Parameters

Path Parameters

required

A primary key, written as a decimal string so JavaScript never rounds it. The format makes the Go servers parse it into an int64: a malformed id is refused as a 400 before a handler runs. The pattern says the same in the contract, so a client (or a fuzzer) can tell a malformed id from a valid one without trying it. Eighteen digits is the most a key reaches, so every id the schema admits fits an int64.

string format: int64

/^[0-9]{1,18}$/

Responses

204

There is no content to send for this request, but the headers may be useful.

400

RFC 7807 bad request response

application/problem+json

RFC 7807 Problem Details

object

code

Why the request was refused, when the client should act on it

string

Allowed values: second_factor_required email_verification_required signup_closed

type

A URI reference that identifies the problem type

string

title

A short, human-readable summary of the problem type

string

status

HTTP status code

integer format: int32

detail

A human-readable explanation specific to this occurrence

string

instance

A URI reference that identifies the specific occurrence

string

errors

Validation errors grouped by field

object

key

additional properties

Array<string>

form

Form-level validation error

string

fields

Field validation errors

object

key

additional properties

string

retryAfter

Seconds to wait before retrying; set on a 429 so a client that only sees the body can show the wait

integer format: int32

debug

Why a 500 happened, sent only by a development server (SPHERICON_ENV=development)

object

error

required

The error that failed the request, or the panic value

string

stack

The goroutine stack of a panic; absent for an error a handler returned

string

requestId

The request id the server log carries for this request

string

method

required

The HTTP method of the failed request

string

path

required

The path of the failed request

string

Example

{
  "code": "second_factor_required"
}

401

RFC 7807 unauthorized response

application/problem+json

RFC 7807 Problem Details

object

code

Why the request was refused, when the client should act on it

string

Allowed values: second_factor_required email_verification_required signup_closed

type

A URI reference that identifies the problem type

string

title

A short, human-readable summary of the problem type

string

status

HTTP status code

integer format: int32

detail

A human-readable explanation specific to this occurrence

string

instance

A URI reference that identifies the specific occurrence

string

errors

Validation errors grouped by field

object

key

additional properties

Array<string>

form

Form-level validation error

string

fields

Field validation errors

object

key

additional properties

string

retryAfter

Seconds to wait before retrying; set on a 429 so a client that only sees the body can show the wait

integer format: int32

debug

Why a 500 happened, sent only by a development server (SPHERICON_ENV=development)

object

error

required

The error that failed the request, or the panic value

string

stack

The goroutine stack of a panic; absent for an error a handler returned

string

requestId

The request id the server log carries for this request

string

method

required

The HTTP method of the failed request

string

path

required

The path of the failed request

string

Example

{
  "code": "second_factor_required"
}

404

RFC 7807 not found response

application/problem+json

RFC 7807 Problem Details

object

code

Why the request was refused, when the client should act on it

string

Allowed values: second_factor_required email_verification_required signup_closed

type

A URI reference that identifies the problem type

string

title

A short, human-readable summary of the problem type

string

status

HTTP status code

integer format: int32

detail

A human-readable explanation specific to this occurrence

string

instance

A URI reference that identifies the specific occurrence

string

errors

Validation errors grouped by field

object

key

additional properties

Array<string>

form

Form-level validation error

string

fields

Field validation errors

object

key

additional properties

string

retryAfter

Seconds to wait before retrying; set on a 429 so a client that only sees the body can show the wait

integer format: int32

debug

Why a 500 happened, sent only by a development server (SPHERICON_ENV=development)

object

error

required

The error that failed the request, or the panic value

string

stack

The goroutine stack of a panic; absent for an error a handler returned

string

requestId

The request id the server log carries for this request

string

method

required

The HTTP method of the failed request

string

path

required

The path of the failed request

string

Example

{
  "code": "second_factor_required"
}

409

RFC 7807 conflict response for a removal refused because live work still uses the row (ADR 0049): 409 with usedBy naming the users. Every refused removal of a Segment, Tag, Integration, Sending domain or Automation answers it.

application/problem+json

The body of a refused removal (ADR 0049): ProblemDetails plus the rows that use it

object

code

Why the request was refused, when the client should act on it

string

Allowed values: second_factor_required email_verification_required signup_closed

type

A URI reference that identifies the problem type

string

title

A short, human-readable summary of the problem type

string

status

HTTP status code

integer format: int32

detail

A human-readable explanation specific to this occurrence

string

instance

A URI reference that identifies the specific occurrence

string

errors

Validation errors grouped by field

object

key

additional properties

Array<string>

form

Form-level validation error

string

fields

Field validation errors

object

key

additional properties

string

retryAfter

Seconds to wait before retrying; set on a 429 so a client that only sees the body can show the wait

integer format: int32

debug

Why a 500 happened, sent only by a development server (SPHERICON_ENV=development)

object

error

required

The error that failed the request, or the panic value

string

stack

The goroutine stack of a panic; absent for an error a handler returned

string

requestId

The request id the server log carries for this request

string

method

required

The HTTP method of the failed request

string

path

required

The path of the failed request

string

usedBy

required

The live rows that use the one a removal was refused for, never empty

Array<object>

A row that uses the one a removal was refused for: what a client shows to say what to change first

object

kind

required

What kind of row it is

string

Allowed values: broadcast automation segment enrollment

required

Its id

string format: int64

/^[0-9]{1,18}$/

name

required

Its name

string

count

How many rows the entry stands for; absent means one. An enrollment entry names the Automation (id, name) and counts its Enrollments.

integer format: int32

Example

{
  "code": "second_factor_required",
  "usedBy": [
    {
      "kind": "broadcast"
    }
  ]
}

429

RFC 7807 too many requests response: a rate limit was exceeded (ADR 0025)

application/problem+json

RFC 7807 Problem Details

object

code

Why the request was refused, when the client should act on it

string

Allowed values: second_factor_required email_verification_required signup_closed

type

A URI reference that identifies the problem type

string

title

A short, human-readable summary of the problem type

string

status

HTTP status code

integer format: int32

detail

A human-readable explanation specific to this occurrence

string

instance

A URI reference that identifies the specific occurrence

string

errors

Validation errors grouped by field

object

key

additional properties

Array<string>

form

Form-level validation error

string

fields

Field validation errors

object

key

additional properties

string

retryAfter

Seconds to wait before retrying; set on a 429 so a client that only sees the body can show the wait

integer format: int32

debug

Why a 500 happened, sent only by a development server (SPHERICON_ENV=development)

object

error

required

The error that failed the request, or the panic value

string

stack

The goroutine stack of a panic; absent for an error a handler returned

string

requestId

The request id the server log carries for this request

string

method

required

The HTTP method of the failed request

string

path

required

The path of the failed request

string

Example

{
  "code": "second_factor_required"
}

Headers

Retry-After

required

integer format: int32

Seconds to wait before retrying

X-RateLimit-Limit

required

integer format: int32

The request budget of the window that was exceeded

X-RateLimit-Remaining

required

integer format: int32

Requests left in the current window

X-RateLimit-Reset

required

integer format: int64

Unix time at which the window resets