Retrieve prompt | Respan Docs

import requests
url = "https://api.respan.ai/api/prompts/prompt_id/"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.json())

{
  "id": "prompt_abc123",
  "name": "Customer Support Assistant",
  "description": "Handles customer support queries with empathy",
  "tags": [
    {
      "id": "tag_abc123",
      "name": "support",
      "color": "#3B82F6",
      "created_at": "2026-01-01T00:00:00Z",
      "updated_at": "2026-01-01T00:00:00Z"
    }
  ],
  "current_version": {
    "version": 3,
    "model": "gpt-4",
    "messages": [
      {
        "role": "system",
        "content": "You are a helpful customer support assistant."
      }
    ],
    "updated_at": "2026-01-20T10:30:00Z"
  },
  "live_version": {
    "version": 2,
    "model": "gpt-3.5-turbo",
    "updated_at": "2026-01-15T08:00:00Z"
  },
  "created_at": "2026-01-01T00:00:00Z",
  "updated_at": "2026-01-20T10:30:00Z"
}

Retrieves a specific prompt by ID, including its current version, live version, and tags.

Python

1 import requests
2 
3 url = "https://api.respan.ai/api/prompts/{prompt_id}/"
4 api_key = "YOUR_RESPAN_API_KEY"
5 headers = {
6     "Authorization": f"Bearer {api_key}",
7     "Content-Type": "application/json"
8 }
9 
10 response = requests.get(url, headers=headers)
11 print(response.json())

TypeScript

1 fetch('https://api.respan.ai/api/prompts/{prompt_id}/', {
2   method: 'GET',
3   headers: {
4     'Content-Type': 'application/json',
5     'Authorization': 'Bearer YOUR_RESPAN_API_KEY'
6   }
7 })
8 .then(response => response.json())
9 .then(data => console.log(data));

Retrieves a specific prompt by ID, including its current version, live version, and tags. ```Python Python import requests url = "https://api.respan.ai/api/prompts/{prompt_id}/" api_key = "YOUR_RESPAN_API_KEY" headers = { "Authorization": f"Bearer {api_key}", "Content-Type": "application/json" } response = requests.get(url, headers=headers) print(response.json()) ``` ```TypeScript TypeScript fetch('https://api.respan.ai/api/prompts/{prompt_id}/', { method: 'GET', headers: { 'Content-Type': 'application/json', 'Authorization': 'Bearer YOUR_RESPAN_API_KEY' } }) .then(response => response.json()) .then(data => console.log(data)); ```

Authentication

AuthorizationBearer

API key authentication. Get your API key from https://platform.respan.ai/platform/api-keys

Path parameters

prompt_idstringRequired

The unique prompt identifier

Response

Prompt details

Errors

401

Unauthorized Error

404

Not Found Error

1	import requests
2
3	url = "https://api.respan.ai/api/prompts/{prompt_id}/"
4	api_key = "YOUR_RESPAN_API_KEY"
5	headers = {
6	"Authorization": f"Bearer {api_key}",
7	"Content-Type": "application/json"
8	}
9
10	response = requests.get(url, headers=headers)
11	print(response.json())

1	fetch('https://api.respan.ai/api/prompts/{prompt_id}/', {
2	method: 'GET',
3	headers: {
4	'Content-Type': 'application/json',
5	'Authorization': 'Bearer YOUR_RESPAN_API_KEY'
6	}
7	})
8	.then(response => response.json())
9	.then(data => console.log(data));