Create a Elemental

Create new elementals

Create new prompts, snippets, and documents.

Create Multiple Elementals

post

Creates multiple elementals in a single request.

Returns 201 Created if all succeed, or 206 Partial Content if some fail.

Authorizations

ApiKeyAuth

x-api-keystringRequired

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

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

Bodyobject[]

application/json

idstringOptional

titlestring · min: 10 · max: 100Required

Title (10-100 characters)

type_idinteger · enumRequired

1=Prompt, 2=Snippet, 3=Document

Possible values:

templatestringRequired

Content/template text with optional

template_overwrite_contentbooleanOptional

descriptionstringOptional

commandstringOptional

visibilityintegerOptional

1=Public, 2=Unlisted

Default: 1

category_idintegerRequired

topic_idsinteger[]Optional

Required for prompts (type_id=1)

is_premiumbooleanOptional

is_fixed_pricebooleanOptional

priceintegerOptional

price_originalintegerOptional

video_urlstringOptional

Responses

201

All elementals created successfully

206

Partial success - some elementals created

400

Invalid request body

post

/v1/user/elementals

cURL

curl -X POST "https://api-integrations.snackprompt.com/v1/user/elementals" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '[
    {"title": "Prompt 1", "type_id": 1, "template": "Write about #topic", "category_id": 1, "topic_ids": [1]},
    {"title": "Prompt 2", "type_id": 1, "template": "Create a #style post", "category_id": 1, "topic_ids": [1]}
  ]'

No content

Create Elemental

post

Creates a new elemental (prompt, snippet, or document).

Template Tags For prompts, use # prefix for variable tags (e.g., #topic, #style). These can be replaced dynamically using the prepare endpoint.

Required Fields

Field	Type	Description
title	string	Title (10-100 characters, must contain at least one letter)
type_id	integer	1=Prompt, 2=Snippet, 3=Document
template	string	Content/template text (required for all types)
category_id	integer	Category ID
topic_ids	array	Array of topic IDs (required for prompts only)

Validation Rules

• Title: Must be 10-100 characters, contain at least one letter

• Template/Body Content: Required for prompt, snippet, or document types

• Topic: Required for prompt type elementals

• Snippets: Title must be unique per user

Authorizations

ApiKeyAuth

x-api-keystringRequired

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

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

Body

application/json

idstringOptional

titlestring · min: 10 · max: 100Required

Title (10-100 characters)

type_idinteger · enumRequired

1=Prompt, 2=Snippet, 3=Document

Possible values:

templatestringRequired

Content/template text with optional

template_overwrite_contentbooleanOptional

descriptionstringOptional

commandstringOptional

visibilityintegerOptional

1=Public, 2=Unlisted

Default: 1

category_idintegerRequired

topic_idsinteger[]Optional

Required for prompts (type_id=1)

is_premiumbooleanOptional

is_fixed_pricebooleanOptional

priceintegerOptional

price_originalintegerOptional

video_urlstringOptional

Responses

201

Elemental created successfully

application/json

400

Invalid request body. Possible errors:

• Title is invalid, it should be between 10 and 100 and contain least one letter
• Elemental type_id is required
• Elemental type_id is invalid

403

Forbidden:

• Snippet title is not unique
• Your Stripe account is incomplete (for premium content)

422

Validation error:

• Item of prompt type must have a topic
• The body content is required for items of type: prompt, snippet, or document

post

/v1/user/elemental

cURLPython

curl -X POST "https://api-integrations.snackprompt.com/v1/user/elemental" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Blog Post Generator",
    "type_id": 1,
    "template": "Write a #tone blog post about #topic",
    "category_id": 1,
    "topic_ids": [1, 2],
    "visibility": 1
  }'

{
  "code": 200,
  "meta": {
    "version": "v1.0.2",
    "is_authenticaded": true,
    "limit": 1,
    "offset": 1,
    "total": 1
  },
  "response": {
    "id": "text",
    "is_list": true,
    "type": {
      "id": 1,
      "name": "text"
    },
    "category": {
      "id": 1,
      "name": "text"
    },
    "topics": [
      {
        "id": 1,
        "name": "text"
      }
    ],
    "title": "text",
    "body_content": "text",
    "body_content_html": "text",
    "body_content_plaintext": "text",
    "body_content_json": {},
    "body_content_placeholders": {
      "list": [
        "text"
      ],
      "plaintext": "text"
    },
    "description": "text",
    "description_plaintext": "text",
    "visibility": {
      "id": 1,
      "name": "text"
    },
    "images": [
      {
        "id": 1,
        "url": "text",
        "width": 1,
        "height": 1,
        "blur": "text"
      }
    ],
    "cover_images": [
      {
        "id": 1,
        "url": "text",
        "width": 1,
        "height": 1,
        "blur": "text"
      }
    ],
    "avatar_image": "text",
    "files": [
      {
        "id": 1,
        "name": "text",
        "size": 1,
        "created_at": "2026-03-07T09:49:17.177Z",
        "url": "text",
        "data": [
          1
        ]
      }
    ],
    "tutorial_steps": [
      {
        "id": 1,
        "title": "text",
        "description": "text",
        "video_url": "text"
      }
    ],
    "url": "text",
    "is_premium": true,
    "price": 1,
    "average_rate": 1,
    "video_url": "text",
    "created_at": "2026-03-07T09:49:17.177Z",
    "updated_at": "2026-03-07T09:49:17.177Z",
    "user": {
      "id": "text",
      "name": "text",
      "username": "text",
      "email": "text",
      "avatar": "text"
    },
    "comments": [
      {
        "id": 1,
        "message": "text",
        "created_at": "2026-03-07T09:49:17.177Z",
        "updated_at": "2026-03-07T09:49:17.177Z",
        "total_votes": 1,
        "user": {
          "id": "text",
          "name": "text",
          "username": "text",
          "email": "text",
          "avatar": "text"
        },
        "replies": [
          {
            "id": 1,
            "message": "text",
            "parent_id": 1,
            "created_at": "2026-03-07T09:49:17.177Z",
            "updated_at": "2026-03-07T09:49:17.177Z",
            "total_votes": 1,
            "user": {
              "id": "text",
              "name": "text",
              "username": "text",
              "email": "text",
              "avatar": "text"
            }
          }
        ]
      }
    ],
    "total_comments": 1,
    "rates": [
      {
        "id": 1,
        "message": "text",
        "rating": 1,
        "created_at": "2026-03-07T09:49:17.177Z",
        "updated_at": "2026-03-07T09:49:17.177Z",
        "total_votes": 1,
        "user": {
          "id": "text",
          "name": "text",
          "username": "text",
          "email": "text",
          "avatar": "text"
        }
      }
    ],
    "total_rates": 1,
    "total_sales": 1,
    "total_upvotes": 1,
    "total_uses": 1,
    "total_saves": 1,
    "command": "text",
    "columns": [
      {
        "id": "text",
        "title": "text",
        "description": "text",
        "description_plaintext": "text",
        "visibility": {
          "id": 1,
          "name": "text"
        },
        "type": {
          "id": 1,
          "name": "text"
        },
        "topics": [
          {
            "id": 1,
            "name": "text"
          }
        ],
        "items": [
          "[Circular Reference]"
        ],
        "total_items": 1,
        "cover_images": [
          {
            "id": 1,
            "url": "text",
            "width": 1,
            "height": 1,
            "blur": "text"
          }
        ],
        "images": [
          {
            "id": 1,
            "url": "text",
            "width": 1,
            "height": 1,
            "blur": "text"
          }
        ],
        "files": [
          {
            "id": 1,
            "name": "text",
            "size": 1,
            "created_at": "2026-03-07T09:49:17.177Z",
            "url": "text",
            "data": [
              1
            ]
          }
        ],
        "avatar_image": "text",
        "video_url": "text",
        "tutorial_steps": [
          {
            "id": 1,
            "title": "text",
            "description": "text",
            "video_url": "text"
          }
        ],
        "url": "text",
        "is_premium": true,
        "price": 1,
        "created_at": "2026-03-07T09:49:17.177Z",
        "updated_at": "2026-03-07T09:49:17.177Z",
        "is_saved": true,
        "is_favorite": true,
        "is_voted": true,
        "average_rate": 1,
        "rates": [
          {
            "id": 1,
            "message": "text",
            "rating": 1,
            "created_at": "2026-03-07T09:49:17.177Z",
            "updated_at": "2026-03-07T09:49:17.177Z",
            "total_votes": 1,
            "user": {
              "id": "text",
              "name": "text",
              "username": "text",
              "email": "text",
              "avatar": "text"
            }
          }
        ],
        "total_rates": 1,
        "total_saves": 1,
        "total_upvotes": 1,
        "total_uses": 1,
        "total_sales": 1,
        "user": {
          "id": "text",
          "name": "text",
          "username": "text",
          "email": "text",
          "avatar": "text"
        },
        "last_saves": [
          {
            "id": "text",
            "name": "text",
            "username": "text",
            "email": "text",
            "avatar": "text"
          }
        ],
        "table_id": "text",
        "table_orientation": "text",
        "tags": [
          {
            "id": "scZahUfID",
            "title": "text",
            "color": "text",
            "description": "text",
            "user_id": "text",
            "created_at": "2026-03-07T09:49:17.177Z",
            "updated_at": "2026-03-07T09:49:17.177Z"
          }
        ],
        "knowledge_base": {},
        "knowledge_base_json": {},
        "settings": {
          "is_knowledge_base": true,
          "is_template": true,
          "is_system": true
        }
      }
    ],
    "rows": [
      {
        "id": "text",
        "title": "text",
        "description": "text",
        "description_plaintext": "text",
        "visibility": {
          "id": 1,
          "name": "text"
        },
        "type": {
          "id": 1,
          "name": "text"
        },
        "topics": [
          {
            "id": 1,
            "name": "text"
          }
        ],
        "items": [
          "[Circular Reference]"
        ],
        "total_items": 1,
        "cover_images": [
          {
            "id": 1,
            "url": "text",
            "width": 1,
            "height": 1,
            "blur": "text"
          }
        ],
        "images": [
          {
            "id": 1,
            "url": "text",
            "width": 1,
            "height": 1,
            "blur": "text"
          }
        ],
        "files": [
          {
            "id": 1,
            "name": "text",
            "size": 1,
            "created_at": "2026-03-07T09:49:17.177Z",
            "url": "text",
            "data": [
              1
            ]
          }
        ],
        "avatar_image": "text",
        "video_url": "text",
        "tutorial_steps": [
          {
            "id": 1,
            "title": "text",
            "description": "text",
            "video_url": "text"
          }
        ],
        "url": "text",
        "is_premium": true,
        "price": 1,
        "created_at": "2026-03-07T09:49:17.177Z",
        "updated_at": "2026-03-07T09:49:17.177Z",
        "is_saved": true,
        "is_favorite": true,
        "is_voted": true,
        "average_rate": 1,
        "rates": [
          {
            "id": 1,
            "message": "text",
            "rating": 1,
            "created_at": "2026-03-07T09:49:17.177Z",
            "updated_at": "2026-03-07T09:49:17.177Z",
            "total_votes": 1,
            "user": {
              "id": "text",
              "name": "text",
              "username": "text",
              "email": "text",
              "avatar": "text"
            }
          }
        ],
        "total_rates": 1,
        "total_saves": 1,
        "total_upvotes": 1,
        "total_uses": 1,
        "total_sales": 1,
        "user": {
          "id": "text",
          "name": "text",
          "username": "text",
          "email": "text",
          "avatar": "text"
        },
        "last_saves": [
          {
            "id": "text",
            "name": "text",
            "username": "text",
            "email": "text",
            "avatar": "text"
          }
        ],
        "table_id": "text",
        "table_orientation": "text",
        "tags": [
          {
            "id": "scZahUfID",
            "title": "text",
            "color": "text",
            "description": "text",
            "user_id": "text",
            "created_at": "2026-03-07T09:49:17.177Z",
            "updated_at": "2026-03-07T09:49:17.177Z"
          }
        ],
        "knowledge_base": {},
        "knowledge_base_json": {},
        "settings": {
          "is_knowledge_base": true,
          "is_template": true,
          "is_system": true
        }
      }
    ],
    "tags": [
      {
        "id": "scZahUfID",
        "title": "text",
        "color": "text",
        "description": "text",
        "user_id": "text",
        "created_at": "2026-03-07T09:49:17.177Z",
        "updated_at": "2026-03-07T09:49:17.177Z"
      }
    ],
    "knowledge_base": {},
    "knowledge_base_json": {},
    "settings": {
      "is_knowledge_base": true,
      "is_template": true,
      "is_system": true
    }
  }
}