Tags

Add tags to a post

post

Adds multiple tags to a post. The tags can be assigned by AI, ADMIN, or USER. AI and ADMIN require an admin token for authentication, while USER requires user authentication.

Body

application/json

postIdstring · uuidOptionalExample: 550e8400-e29b-41d4-a716-446655440000

tagsstring[]OptionalExample: ["exampleTag1","exampleTag2"]

assignedBystring · enumOptionalExample: USERPossible values:

Responses

200

Tags successfully added to the post

application/json

401

Unauthorized - Invalid token or insufficient permissions

404

Not Found - The post with the specified ID does not exist

post

/tags/post

HTTPcURLJavaScriptPython

POST /tags/post HTTP/1.1
Host: 
Content-Type: application/json
Accept: */*
Content-Length: 106

{
  "postId": "550e8400-e29b-41d4-a716-446655440000",
  "tags": [
    "exampleTag1",
    "exampleTag2"
  ],
  "assignedBy": "USER"
}

{
  "tagId": "550e8400-e29b-41d4-a716-446655440000",
  "name": "exampleTag",
  "assignedBy": "AI",
  "created_at": "2026-01-26T23:28:34.735Z",
  "updated_at": "2026-01-26T23:28:34.735Z"
}

Add tags to an asset

post

Adds multiple tags to an asset. The tags can be assigned by AI, ADMIN, or USER. AI and ADMIN require an admin token for authentication, while USER requires user authentication.

Body

application/json

assetIdstring · uuidOptionalExample: 550e8400-e29b-41d4-a716-446655440000

tagsstring[]OptionalExample: ["exampleTag1","exampleTag2"]

assignedBystring · enumOptionalExample: USERPossible values:

Responses

200

Tags successfully added to the asset

application/json

401

Unauthorized - Invalid token or insufficient permissions

404

Not Found - The asset with the specified ID does not exist

post

/tags/asset

HTTPcURLJavaScriptPython

POST /tags/asset HTTP/1.1
Host: 
Content-Type: application/json
Accept: */*
Content-Length: 107

{
  "assetId": "550e8400-e29b-41d4-a716-446655440000",
  "tags": [
    "exampleTag1",
    "exampleTag2"
  ],
  "assignedBy": "USER"
}

{
  "tagId": "550e8400-e29b-41d4-a716-446655440000",
  "name": "exampleTag",
  "assignedBy": "AI",
  "created_at": "2026-01-26T23:28:34.735Z",
  "updated_at": "2026-01-26T23:28:34.735Z"
}

Remove tags from a post

post

Removes multiple tags from a post. AI and ADMIN require an admin token for authentication, while USER requires user authentication.

Body

application/json

postIdstring · uuidOptionalExample: 550e8400-e29b-41d4-a716-446655440000

tagsstring[]OptionalExample: ["exampleTag1","exampleTag2"]

assignedBystring · enumOptionalExample: USERPossible values:

Responses

204

No Content - Tags successfully removed from the post

No content

401

Unauthorized - Invalid token or insufficient permissions

404

Not Found - The tags or post with the specified ID do not exist

post

/tags/post/remove

HTTPcURLJavaScriptPython

POST /tags/post/remove HTTP/1.1
Host: 
Content-Type: application/json
Accept: */*
Content-Length: 106

{
  "postId": "550e8400-e29b-41d4-a716-446655440000",
  "tags": [
    "exampleTag1",
    "exampleTag2"
  ],
  "assignedBy": "USER"
}

No content

Remove tags from an asset

post

Removes multiple tags from an asset. AI and ADMIN require an admin token for authentication, while USER requires user authentication.

Body

application/json

assetIdstring · uuidOptionalExample: 550e8400-e29b-41d4-a716-446655440000

tagsstring[]OptionalExample: ["exampleTag1","exampleTag2"]

assignedBystring · enumOptionalExample: USERPossible values:

Responses

204

No Content - Tags successfully removed from the asset

No content

401

Unauthorized - Invalid token or insufficient permissions

404

Not Found - The tags or asset with the specified ID do not exist

post

/tags/asset/remove

HTTPcURLJavaScriptPython

POST /tags/asset/remove HTTP/1.1
Host: 
Content-Type: application/json
Accept: */*
Content-Length: 107

{
  "assetId": "550e8400-e29b-41d4-a716-446655440000",
  "tags": [
    "exampleTag1",
    "exampleTag2"
  ],
  "assignedBy": "USER"
}

No content