API Reference

Interact directly with the Prompterella API to stage contexts from your frontend, backend or custom tools.

POST/api/v1/stage

Stage a prompt and context for AI consumption. This endpoint accepts your payload and returns a unique, time-limited ID and a gateway URL.

Request Body

Field	Type	Required	Description
prompt	string	Yes	The instruction for the AI model.
text	string	Yes	The primary context/article/code payload.
sourceUrl	string	No	Optional reference URL for the source.

🔒 Data Retention

All staged contexts are stored in memory and automatically purged after 2 hours. We do not store data long-term.

Example RequestcURL

curl -X POST https://prompterella.com/api/v1/stage \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "Summarize this article",
    "text": "Your large context here...",
    "sourceUrl": "https://example.com/article"
  }'

ResponseJSON

{
  "id": "abc123xyz",
  "gatewayUrl": "https://prompterella.com/gateway/abc123xyz",
  "expiresAt": "2026-02-10T03:21:19.034Z"
}