Delete a tag

DELETE

/tags/{tag}

const url = 'https://feed.work.optidata.cloud/api/tags/89';
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 https://feed.work.optidata.cloud/api/tags/89 \
  --header 'Authorization: Bearer <token>'

Deletes a tag and removes it from every post.

Authorizations

bearerAuth

Parameters

Path Parameters

tag

required

integer

Numeric id of the tag.

Responses

200

The deleted tag.

application/json

A tag that labels posts.

object

required

integer

name

required

string

slug

string

type

string | null

description

string | null

color

required

string

Allowed values: primary secondary success danger warning info dark

order_column

integer | null

created_at

string format: date-time

updated_at

string format: date-time

Examples

example

{
  "id": 89,
  "name": "hr",
  "slug": "hr",
  "type": null,
  "description": null,
  "color": "success",
  "order_column": 68,
  "created_at": "2026-09-02T12:10:14.000000Z",
  "updated_at": "2026-09-02T12:10:14.000000Z"
}

401

No authentication key was sent.

application/json

Authentication failures use an error key.

object

error

required

string

Examples

example

{
  "error": "JWT passport exception: Missing bearer token in request"
}

404

No matching resource, or it is not reachable through this path.

application/json

object

message

required

string

Examples

example

{
  "message": "No query results for model [App\\Models\\Category] 864"
}

419

The authentication key is expired or not recognised. Get a fresh one and retry.

application/json

Authentication failures use an error key.

object

error

required

string

Examples

example

{
  "error": "JWT passport expired: Passport expired"
}