REST API v1

legacy, frozen

v1 has one endpoint and it will keep working exactly as it does today. It is documented here for integrations that already use it. New work should use v2, which adds versions, variables, write endpoints and the MCP server. See API versions.

GET /api/v1/prompts/:id

Returns the production version of a prompt with Prompt Guard appended. Query parameters are ignored. Authenticate with the project API key in x-api-key.

curl https://superprompts.app/api/v1/prompts/<PROMPT_ID> \
  -H "x-api-key: <API_KEY>"

{
  "success": true,
  "data": {
    "id": "e0a6c9d2-72e8-447e-a207-7e7f3a19be49",
    "prompt": "<role>You help the customer.</role>\n\n<guard_role>…</guard_role>",
    "sections": [
      { "id": "role", "title": "Role", "content": "You help the customer." }
    ],
    "tools": [],
    "version": "8481c559defedd0417ed86139fd2fbe5d4e83b72e967478eb162246248ffc9d8",
    "created_at": "2026-02-06T23:05:36.707Z",
    "updated_at": "2026-08-23T06:59:15.619Z"
  }
}

Since September 2026 the payload also includes name, description, variables, label and production_version. These are additions; the fields above never change. Responses carry Deprecation: true and X-API-Version: 1.

Errors and limits

401 missing or invalid key; 404 prompt not in this project; 429 rate limit (60 requests per minute per organization on the Free plan).
Repeated invalid keys from one client are throttled with 429 and a Retry-After header.