Delete Category

DELETE/api/v1/dashboard/content/categories/{category_id}

Overview

Permanently deletes a category. Posts assigned to this category will have it removed. If the category has children, they are promoted to top-level (their parent_id is set to null). 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
category_id	string (UUID)	Yes	The unique identifier of the category to delete

Response

successboolean

Always true on successful deletion

Example Request

cURL

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

Python

import requests

category_id = "cat-004-uuid"

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

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

JavaScript

const categoryId = "cat-004-uuid";

const resp = await fetch(
  `https://spideriq.ai/api/v1/dashboard/content/categories/${categoryId}`,
  {
    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	Category deleted successfully
401	Unauthorized	Invalid or missing Bearer token
404	Not Found	Category not found or belongs to another client

Related Endpoints

➕

Create Category

Create a new category

pen

Update Category

Update a category

folder

List Categories

List all categories

📋

List Posts

List posts (filter by category)