Create a Elemental
Create new elementals
Create new prompts, snippets, and documents.
Creates multiple elementals in a single request.
Authorizations
x-api-keystringRequired
API Key authentication. Get your key at snackprompt.com/api-keys.
Example: x-api-key: sk-your-api-key-here
Bodyobject · ElementalPayload[]
idstringOptional
titlestring · min: 10 · max: 100Required
Title (10-100 characters)
type_idinteger · enumRequiredPossible values:
1=Prompt, 2=Snippet, 3=Document
templatestringRequired
Content/template text with optional
template_overwrite_contentbooleanOptional
descriptionstringOptional
commandstringOptional
visibilityintegerOptionalDefault:
1=Public, 2=Unlisted
1category_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
No content
206
Partial success - some elementals created
400
Invalid request body
post/v1/user/elementals
cURLcurl -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
Creates a new elemental (prompt, snippet, or document).
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
x-api-keystringRequired
API Key authentication. Get your key at snackprompt.com/api-keys.
Example: x-api-key: sk-your-api-key-here
Body
idstringOptional
titlestring · min: 10 · max: 100Required
Title (10-100 characters)
type_idinteger · enumRequiredPossible values:
1=Prompt, 2=Snippet, 3=Document
templatestringRequired
Content/template text with optional
template_overwrite_contentbooleanOptional
descriptionstringOptional
commandstringOptional
visibilityintegerOptionalDefault:
1=Public, 2=Unlisted
1category_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
codeintegerOptionalExample:
HTTP status code
200400
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
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-01-01T00:00:00.000Z",
"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-01-01T00:00:00.000Z",
"updated_at": "2026-01-01T00:00:00.000Z",
"user": {
"id": "text",
"name": "text",
"username": "text",
"email": "text",
"avatar": "text"
},
"comments": [
{
"id": 1,
"message": "text",
"created_at": "2026-01-01T00:00:00.000Z",
"updated_at": "2026-01-01T00:00:00.000Z",
"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-01-01T00:00:00.000Z",
"updated_at": "2026-01-01T00:00:00.000Z",
"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-01-01T00:00:00.000Z",
"updated_at": "2026-01-01T00:00:00.000Z",
"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-01-01T00:00:00.000Z",
"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-01-01T00:00:00.000Z",
"updated_at": "2026-01-01T00:00:00.000Z",
"is_saved": true,
"is_favorite": true,
"is_voted": true,
"average_rate": 1,
"rates": [
{
"id": 1,
"message": "text",
"rating": 1,
"created_at": "2026-01-01T00:00:00.000Z",
"updated_at": "2026-01-01T00:00:00.000Z",
"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-01-01T00:00:00.000Z",
"updated_at": "2026-01-01T00:00:00.000Z"
}
],
"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-01-01T00:00:00.000Z",
"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-01-01T00:00:00.000Z",
"updated_at": "2026-01-01T00:00:00.000Z",
"is_saved": true,
"is_favorite": true,
"is_voted": true,
"average_rate": 1,
"rates": [
{
"id": 1,
"message": "text",
"rating": 1,
"created_at": "2026-01-01T00:00:00.000Z",
"updated_at": "2026-01-01T00:00:00.000Z",
"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-01-01T00:00:00.000Z",
"updated_at": "2026-01-01T00:00:00.000Z"
}
],
"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-01-01T00:00:00.000Z",
"updated_at": "2026-01-01T00:00:00.000Z"
}
],
"knowledge_base": {},
"knowledge_base_json": {},
"settings": {
"is_knowledge_base": true,
"is_template": true,
"is_system": true
}
}
}Last updated
Was this helpful?