API Reference

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

POST/api/v1/context

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.
ttl	integer	No	Time-to-live in minutes (10–2880). Default: `120` (2 hours).

Data Retention

Staged contexts expire after a configurable TTL (default: 2 hours, range: 10 min – 48 hours). Expired records are automatically purged. We do not store data long-term.

Example RequestcURL

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

ResponseJSON

{
  "id": "abc123xyz",
  "gatewayUrl": "https://prompterella.com/gateway/abc123xyz",
  "expiresAt": "2026-03-31T01:53:53.323Z"
}