Update Tag

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

Overview

Updates an existing tag. Only the fields included in the request body are updated. Changing a tag name or slug automatically updates all posts that reference this tag.

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>
Content-Type	string	Yes	application/json

Path Parameters

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

Request Body

All fields are optional.

Parameter	Type	Description
name	string	Tag display name
slug	string	URL-friendly slug
description	string	Tag description

Response

Returns the full updated tag object.

Example Request

cURL

curl -X PATCH "https://spideriq.ai/api/v1/dashboard/content/tags/tag-004-uuid" \
  -H "Authorization: Bearer $CLIENT_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Lead Gen",
    "description": "Updated description for lead generation tag"
  }'

Python

import requests

tag_id = "tag-004-uuid"

resp = requests.patch(
    f"https://spideriq.ai/api/v1/dashboard/content/tags/{tag_id}",
    headers={"Authorization": f"Bearer {CLIENT_TOKEN}"},
    json={
        "name": "Lead Gen",
        "description": "Updated description for lead generation tag",
    },
)
tag = resp.json()

print(f"Updated: {tag['name']}")

JavaScript

const tagId = "tag-004-uuid";

const resp = await fetch(
  `https://spideriq.ai/api/v1/dashboard/content/tags/${tagId}`,
  {
    method: "PATCH",
    headers: {
      "Authorization": `Bearer ${CLIENT_TOKEN}`,
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      name: "Lead Gen",
      description: "Updated description for lead generation tag",
    }),
  }
);
const tag = await resp.json();

console.log(`Updated: ${tag.name}`);

Example Response

{
  "id": "tag-004-uuid",
  "name": "Lead Gen",
  "slug": "lead-generation",
  "description": "Updated description for lead generation tag"
}

Status Codes

Status Code	Meaning	Description
200	OK	Tag updated successfully
400	Bad Request	Invalid field values
401	Unauthorized	Invalid or missing Bearer token
404	Not Found	Tag not found or belongs to another client
409	Conflict	Slug already in use by another tag

Related Endpoints

➕

Create Tag

Create a new tag

trash

Delete Tag

Delete a tag

tags

List Tags

List all tags

pen

Update Post

Update post tags