REST API overview

• Send requests to https://api.promptessor.com/v1.
• Send JSON request bodies with Content-Type: application/json.
• Authenticate with a Bearer API key or OAuth access token.
• Send X-Request-Id when you want to correlate your identifier with PrompTessor logs; otherwise PrompTessor generates one.
• Send a unique Idempotency-Key on every credit-consuming AI operation.
• Send Prefer: respond-async when an AI endpoint supports deferred processing.

POST /v1/prompts/analyze HTTP/1.1
Host: api.promptessor.com
Authorization: Bearer pt_live_YOUR_API_KEY
Content-Type: application/json
X-Request-Id: req_from_your_system_123
Idempotency-Key: analysis-job-123

{"prompt":"Summarize the customer interview notes","targetModel":"Claude"}

Read requests return a data envelope. AI requests return an operation-shaped result. All API responses set X-Request-Id and no-store cache control. Rate-limited responses use HTTP 429.

{
  "data": { "object": "list", "data": [] },
  "requestId": "req_..."
}