Deploy a prompt version

curl -X POST https://api.respan.ai/api/prompts/prompt_id/deployments/ \
     -H "Authorization: Bearer sk_live_xxxxx" \
     -H "Content-Type: application/json" \
     -d '{
  "version": 3
}'

{
  "id": "pv_abc123",
  "prompt_version_id": "pv_abc123",
  "version": 3,
  "description": "Improved system prompt for better context handling",
  "messages": [
    {
      "role": "system",
      "content": "You are a helpful assistant. Context: {{context}}"
    }
  ],
  "model": "gpt-4o",
  "readonly": true,
  "is_deployed": true,
  "edited_by": {
    "id": 123,
    "email": "user@example.com",
    "first_name": "John",
    "last_name": "Doe"
  },
  "created_at": "2026-02-27T10:00:00Z",
  "updated_at": "2026-02-27T10:00:00Z"
}

Deploy a committed version as the live version for this prompt.

Path parameters

prompt_idstringRequired

The unique prompt identifier.

Request

This endpoint expects an object.

versionintegerRequired

Version number to deploy as live.

Response

Version deployed successfully.

idstring

prompt_version_idstring

versioninteger

descriptionstring or null

messageslist of maps from strings to any

modelstring

readonlyboolean

is_deployedboolean

edited_byobject

created_atdatetime

updated_atdatetime

Errors

400

Bad Request Error

401

Unauthorized Error

404

Not Found Error

Deploy a prompt version

Deploy a prompt version

Path parameters

Headers

Request

Response

Errors

Path parameters

Headers

Request

Response

Errors

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

1	{
2	"id": "pv_abc123",
3	"prompt_version_id": "pv_abc123",
4	"version": 3,
5	"description": "Improved system prompt for better context handling",
6	"messages": [
7	{
8	"role": "system",
9	"content": "You are a helpful assistant. Context: {{context}}"
10	}
11	],
12	"model": "gpt-4o",
13	"readonly": true,
14	"is_deployed": true,
15	"edited_by": {
16	"id": 123,
17	"email": "user@example.com",
18	"first_name": "John",
19	"last_name": "Doe"
20	},
21	"created_at": "2026-02-27T10:00:00Z",
22	"updated_at": "2026-02-27T10:00:00Z"
23	}