Delete Tag

DELETE/api/v1/dashboard/content/tags/{tag_id}

Overview

Permanently deletes a tag. Posts that used this tag will have it removed from their tag list. This action cannot be undone.

Authentication

info

Bearer authentication required - Pass your credentials as Authorization: Bearer <client_id>:<api_key>:<api_secret>.

Headers

Header	Type	Required	Description
Authorization	string	Yes	Bearer <client_id>:<api_key>:<api_secret>

Path Parameters

Parameter	Type	Required	Description
tag_id	string (UUID)	Yes	The unique identifier of the tag to delete

Response

successboolean

Always true on successful deletion

Example Request

cURL

curl -X DELETE "https://spideriq.ai/api/v1/dashboard/content/tags/tag-004-uuid" \
  -H "Authorization: Bearer $CLIENT_TOKEN"

Python

import requests

tag_id = "tag-004-uuid"

resp = requests.delete(
    f"https://spideriq.ai/api/v1/dashboard/content/tags/{tag_id}",
    headers={"Authorization": f"Bearer {CLIENT_TOKEN}"},
)
result = resp.json()

print(f"Deleted: {result['success']}")

JavaScript

const tagId = "tag-004-uuid";

const resp = await fetch(
  `https://spideriq.ai/api/v1/dashboard/content/tags/${tagId}`,
  {
    method: "DELETE",
    headers: { "Authorization": `Bearer ${CLIENT_TOKEN}` },
  }
);
const result = await resp.json();

console.log(`Deleted: ${result.success}`);

Example Response

{
  "success": true
}

Status Codes

Status Code	Meaning	Description
200	OK	Tag deleted successfully
401	Unauthorized	Invalid or missing Bearer token
404	Not Found	Tag not found or belongs to another client

Related Endpoints

➕

Create Tag

Create a new tag

pen

Update Tag

Update a tag

tags

List Tags

List all tags

📋

List Posts

List posts (filter by tag)