Template Tags

Work with template variable tags like #topic and #style

Template tags are placeholders in prompts (e.g., #topic, #style) that can be dynamically replaced with actual values.

Get Template Tags

get

Return all template variable tags inside an elemental (mostly used in prompts).

Tags like: #name, #age, #state

Use this endpoint to discover what values need to be provided before calling the prepare endpoint.

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

elemental_idstringRequired

Elemental ID

Responses

200

List of template tags

application/json

codeintegerOptional

HTTP status code

Example: 200

401

Unauthorized

404

Elemental not found

application/json

get/v1/elemental/{elemental_id}/tags

cURL

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

{
  "code": 200,
  "meta": {
    "version": "v1.0.2"
  },
  "response": {
    "list": [
      "#topic",
      "#tone",
      "#audience",
      "#length"
    ],
    "plaintext": "#topic #tone #audience #length"
  }
}

Prepare Template

post

Return the elemental template with replaced tags.

This is the key endpoint for generating prompts dynamically. Pass tag values as key-value pairs in the request body.

Request Body Format

{
  "#name": "John",
  "#lastname": "Doe",
  "#topic": "artificial intelligence"
}

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

elemental_idstringRequired

Elemental ID

Body

Key-value pairs where keys are tag names (with

Other propertiesstringOptional

Responses

200

Prepared template with replaced values

application/json

codeintegerOptional

HTTP status code

Example: 200

401

Unauthorized

404

Elemental not found

application/json

post/v1/elemental/{elemental_id}/template/prepare

curl -X POST "https://api-integrations.snackprompt.com/v1/elemental/abc123/template/prepare" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "#topic": "artificial intelligence",
    "#tone": "professional",
    "#audience": "business executives"
  }'

{
  "code": 200,
  "meta": {
    "version": "v1.0.2"
  },
  "response": {
    "result": "Write a professional blog post about artificial intelligence that is approximately 500 words. Target audience: business executives."
  }
}