Retrieve a prompt | Respan Docs

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

{
  "id": "prompt_abc123",
  "name": "Customer Support Assistant",
  "description": "Handles customer support queries with empathy",
  "prompt_slug": "customer-support-assistant",
  "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-4o",
    "updated_at": "2026-01-20T10:30:00Z"
  },
  "live_version": {
    "version": 2,
    "model": "gpt-4o-mini",
    "updated_at": "2026-01-15T08:00:00Z"
  },
  "created_at": "2026-01-01T00:00:00Z",
  "updated_at": "2026-01-20T10:30:00Z"
}

Retrieve a prompt template by ID, including its current and live versions.

Path parameters

prompt_idstringRequired

The unique prompt identifier.

Response

Prompt details.

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

401

Unauthorized Error

404

Not Found Error

Path parameters

Headers

Response

Errors