Create a prompt

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

$	curl -X POST https://api.respan.ai/api/prompts/ \
>	-H "Authorization: Bearer sk_live_xxxxx" \
>	-H "Content-Type: application/json" \
>	-d '{
>	"name": "customer_support"
>	}'

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	"current_version": null,
8	"live_version": null,
9	"created_at": "2026-01-21T12:00:00Z",
10	"updated_at": "2026-01-21T12:00:00Z"
11	}

$	curl -X POST https://api.respan.ai/api/prompts/ \
>	-H "Authorization: Bearer sk_live_xxxxx" \
>	-H "Content-Type: application/json" \
>	-d '{
>	"name": "customer_support"
>	}'

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	"current_version": null,
8	"live_version": null,
9	"created_at": "2026-01-21T12:00:00Z",
10	"updated_at": "2026-01-21T12:00:00Z"
11	}