Retrieve a prompt

GET

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

GET

/api/prompts/:prompt_id/

1 curl https://api.respan.ai/api/prompts/prompt_id/ \
2      -H "Authorization: Bearer sk_live_xxxxx"

1 {
2   "id": "prompt_abc123",
3   "name": "Customer Support Assistant",
4   "description": "Handles customer support queries with empathy",
5   "tags": [
6     {
7       "id": "tag_abc123",
8       "name": "support",
9       "color": "#3B82F6",
10       "created_at": "2026-01-01T00:00:00Z",
11       "updated_at": "2026-01-01T00:00:00Z"
12     }
13   ],
14   "current_version": {
15     "version": 3,
16     "model": "gpt-4",
17     "messages": [
18       {
19         "role": "system",
20         "content": "You are a helpful customer support assistant."
21       }
22     ],
23     "updated_at": "2026-01-20T10:30:00Z"
24   },
25   "live_version": {
26     "version": 2,
27     "model": "gpt-3.5-turbo",
28     "updated_at": "2026-01-15T08:00:00Z"
29   },
30   "created_at": "2026-01-01T00:00:00Z",
31   "updated_at": "2026-01-20T10:30:00Z"
32 }

Retrieve a single prompt by ID, including its current deployed version.

Path parameters

prompt_idstringRequired

The unique prompt identifier

Response

Prompt details

Errors

401

Unauthorized Error

404

Not Found Error

Path parameters

Headers

Response

Errors