Manage Tags

Create and manage tags for categorization

Tags

Tags provide flexible categorization for your content. Create custom tags with colors and descriptions.

Add Tag to Elemental

post

Applies a user tag to an elemental.

Authorizations

x-api-keystringRequired

API Key authentication. Get your key at snackprompt.com/api-keys.

Example: x-api-key: sk-your-api-key-here

Path parameters

idstringRequired

Elemental ID

tag_idintegerRequired

Tag ID

Responses

200

Tag added to elemental

No content

post/v1/user/elemental/{id}/tag/{tag_id}

cURL

curl -X POST "https://api-integrations.snackprompt.com/v1/user/elemental/abc123/tag/1" \
  -H "x-api-key: YOUR_API_KEY"

200

Tag added to elemental

No content

Remove Tag from Elemental

delete

Removes a tag from an elemental.

Authorizations

x-api-keystringRequired

API Key authentication. Get your key at snackprompt.com/api-keys.

Example: x-api-key: sk-your-api-key-here

Path parameters

idstringRequired

tag_idintegerRequired

Responses

200

Tag removed from elemental

No content

delete/v1/user/elemental/{id}/tag/{tag_id}

cURL

curl -X DELETE "https://api-integrations.snackprompt.com/v1/user/elemental/abc123/tag/1" \
  -H "x-api-key: YOUR_API_KEY"

200

Tag removed from elemental

No content

Get User Tags

get

Retrieves all tags created by the authenticated user.

Authorizations

x-api-keystringRequired

API Key authentication. Get your key at snackprompt.com/api-keys.

Example: x-api-key: sk-your-api-key-here

Responses

200

User's tags

application/json

codeintegerOptional

HTTP status code

Example: 200

get/v1/user/tags

cURL

curl -X GET "https://api-integrations.snackprompt.com/v1/user/tags" \
  -H "x-api-key: YOUR_API_KEY"

200

User's tags

{
  "code": 200,
  "meta": {
    "version": "v1.0.2",
    "is_authenticaded": true,
    "limit": 1,
    "offset": 1,
    "total": 1
  },
  "response": [
    {
      "id": "scZahUfID",
      "title": "text",
      "color": "text",
      "description": "text",
      "user_id": "text",
      "created_at": "2026-01-01T00:00:00.000Z",
      "updated_at": "2026-01-01T00:00:00.000Z"
    }
  ]
}

Create Tag

post

Creates a new tag for categorizing elementals.

Required Fields

Field	Type	Description
title	string	Tag name
color	string	Hex color code (e.g., "#FF5733")
elementalTypeId	integer	Elemental type this tag applies to

Authorizations

x-api-keystringRequired

API Key authentication. Get your key at snackprompt.com/api-keys.

Example: x-api-key: sk-your-api-key-here

Body

titlestringRequired

colorstringRequired

Hex color code (e.g., "#FF5733")

descriptionstringOptional

elementalTypeIdintegerRequired

Elemental type this tag applies to

source_user_idstringOptional

source_tag_idstringOptional

Responses

201

Tag created

No content

400

Body should not be empty or error creating tag

post/v1/user/tags

cURL

curl -X POST "https://api-integrations.snackprompt.com/v1/user/tags" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"title": "Favorites", "color": "#FF5733", "description": "My favorites", "elementalTypeId": 1}'

No content

Get All Tags

get

Retrieves all tags including system tags.

Authorizations

x-api-keystringRequired

API Key authentication. Get your key at snackprompt.com/api-keys.

Example: x-api-key: sk-your-api-key-here

Responses

200

All available tags

No content

get/v1/user/tags/all

cURL

curl -X GET "https://api-integrations.snackprompt.com/v1/user/tags/all" \
  -H "x-api-key: YOUR_API_KEY"

200

All available tags

No content

Get Tag by ID

get

Retrieves a specific tag by ID.

Authorizations

x-api-keystringRequired

API Key authentication. Get your key at snackprompt.com/api-keys.

Example: x-api-key: sk-your-api-key-here

Path parameters

idintegerRequired

Responses

200

Tag details

No content

204

Tag not found

get/v1/user/tags/{id}

cURL

curl -X GET "https://api-integrations.snackprompt.com/v1/user/tags/1" \
  -H "x-api-key: YOUR_API_KEY"

No content

Update Tag

put

Updates an existing tag.

Authorizations

x-api-keystringRequired

API Key authentication. Get your key at snackprompt.com/api-keys.

Example: x-api-key: sk-your-api-key-here

Path parameters

idintegerRequired

Body

titlestringOptional

colorstringOptional

descriptionstringOptional

Responses

200

Tag updated

No content

400

Error updating tag

put/v1/user/tags/{id}

cURL

curl -X PUT "https://api-integrations.snackprompt.com/v1/user/tags/1" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"title": "Updated Tag", "color": "#00FF00"}'

No content

Delete Tag

delete

Deletes a tag.

Authorizations

x-api-keystringRequired

API Key authentication. Get your key at snackprompt.com/api-keys.

Example: x-api-key: sk-your-api-key-here

Path parameters

idintegerRequired

Responses

204

Tag deleted

No content

400

Error deleting tag

delete/v1/user/tags/{id}

cURL

curl -X DELETE "https://api-integrations.snackprompt.com/v1/user/tags/1" \
  -H "x-api-key: YOUR_API_KEY"

No content

Get Tag Items

get

Retrieves all elementals with a specific tag.

Authorizations

x-api-keystringRequired

API Key authentication. Get your key at snackprompt.com/api-keys.

Example: x-api-key: sk-your-api-key-here

Path parameters

idintegerRequired

Responses

200

Elementals with this tag

No content

get/v1/user/tags/{id}/items

cURL

curl -X GET "https://api-integrations.snackprompt.com/v1/user/tags/1/items" \
  -H "x-api-key: YOUR_API_KEY"

200

Elementals with this tag

No content