Tags

Last updated 7 months ago

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

postIdstring · uuidoptional

Example: 550e8400-e29b-41d4-a716-446655440000

tagsstring[]optional

Example: ["exampleTag1","exampleTag2"]

assignedBystring · enumoptional

Example: USER

Available options:

Responses

application/json

cURL

JavaScript

Python

HTTP

curl -L \
  --request POST \
  --url '/tags/post' \
  --header 'Content-Type: application/json' \
  --data '{
    "postId": "550e8400-e29b-41d4-a716-446655440000",
    "tags": [
      "exampleTag1",
      "exampleTag2"
    ],
    "assignedBy": "USER"
  }'

200

401

404

{
  "tagId": "550e8400-e29b-41d4-a716-446655440000",
  "name": "exampleTag",
  "assignedBy": "AI",
  "created_at": "2025-04-03T05:58:25.778Z",
  "updated_at": "2025-04-03T05:58:25.778Z"
}

Tags successfully added to the post

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

assetIdstring · uuidoptional

Example: 550e8400-e29b-41d4-a716-446655440000

tagsstring[]optional

Example: ["exampleTag1","exampleTag2"]

assignedBystring · enumoptional

Example: USER

Available options:

Responses

application/json

cURL

JavaScript

Python

HTTP

curl -L \
  --request POST \
  --url '/tags/asset' \
  --header 'Content-Type: application/json' \
  --data '{
    "assetId": "550e8400-e29b-41d4-a716-446655440000",
    "tags": [
      "exampleTag1",
      "exampleTag2"
    ],
    "assignedBy": "USER"
  }'

200

401

404

{
  "tagId": "550e8400-e29b-41d4-a716-446655440000",
  "name": "exampleTag",
  "assignedBy": "AI",
  "created_at": "2025-04-03T05:58:25.778Z",
  "updated_at": "2025-04-03T05:58:25.778Z"
}

Tags successfully added to the asset

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

postIdstring · uuidoptional

Example: 550e8400-e29b-41d4-a716-446655440000

tagsstring[]optional

Example: ["exampleTag1","exampleTag2"]

assignedBystring · enumoptional

Example: USER

Available options:

Responses

cURL

JavaScript

Python

HTTP

curl -L \
  --request POST \
  --url '/tags/post/remove' \
  --header 'Content-Type: application/json' \
  --data '{
    "postId": "550e8400-e29b-41d4-a716-446655440000",
    "tags": [
      "exampleTag1",
      "exampleTag2"
    ],
    "assignedBy": "USER"
  }'

204

401

404

No body

No Content - Tags successfully removed from the post

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

assetIdstring · uuidoptional

Example: 550e8400-e29b-41d4-a716-446655440000

tagsstring[]optional

Example: ["exampleTag1","exampleTag2"]

assignedBystring · enumoptional

Example: USER

Available options:

Responses

cURL

JavaScript

Python

HTTP

curl -L \
  --request POST \
  --url '/tags/asset/remove' \
  --header 'Content-Type: application/json' \
  --data '{
    "assetId": "550e8400-e29b-41d4-a716-446655440000",
    "tags": [
      "exampleTag1",
      "exampleTag2"
    ],
    "assignedBy": "USER"
  }'

204

401

404

No body

No Content - Tags successfully removed from the asset