Create a prompt | Respan Docs

Create a new prompt template.

This endpoint expects an object.

namestringRequired

Prompt name.

descriptionstringOptional

Prompt description.

Prompt created successfully.

idstring

The unique prompt identifier.

namestring

descriptionstring or null

prompt_slugstring or null

tagslist of objects

current_versionobject or null

live_versionobject or null

created_atdatetime

updated_atdatetime

400

Bad Request Error

401

Unauthorized Error

1	curl -X POST https://api.respan.ai/api/prompts/ \
2	-H "Authorization: Bearer sk_live_xxxxx" \
3	-H "Content-Type: application/json" \
4	-d '{
5	"name": "customer_support"
6	}'

1	{
2	"id": "prompt_new123",
3	"name": "Customer Support Assistant",
4	"description": "Handles customer support queries with empathy",
5	"prompt_slug": "customer-support-assistant",
6	"tags": [],
7	"created_at": "2026-01-21T12:00:00Z",
8	"updated_at": "2026-01-21T12:00:00Z"
9	}