Create a prompt

POST

https://api.respan.ai/api/prompts/

Create a new prompt template.

Authentication

AuthorizationBearer

Use your Respan API key for Respan API authentication. Enter only the Respan API key value; clients send Authorization: Bearer <RESPAN_API_KEY>. For /api/responses, OpenAI or Azure OpenAI provider credentials go in Settings -> Providers or the request body credential_override field, not in this auth field.

Request

This endpoint expects an object.

namestringRequired

Prompt name.

descriptionstringOptional

Prompt description.

Response

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

Errors

400

Bad Request Error

401

Unauthorized Error

$	curl -X POST https://api.respan.ai/api/prompts/ \
>	-H "Authorization: Bearer <respanApiKey>" \
>	-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	}