Summarization API Reference

The published specification is version 2026.10.21-1.

Summarize clinical documents, following your instructions. Send a document’s text — or several documents about one patient, including output from the Prep and NLP APIs — and a prompt describing the summary you want: who it is for, what to cover, how long. You get one summary, as Markdown. With several documents, the summary cites them.

Jobs are asynchronous: submit with POST /v1/jobs, poll GET /v1/jobs/{id}, then fetch the result once with GET /v1/jobs/{id}/result. Nothing is kept beyond 24 hours. Send an Idempotency-Key header to make submissions safe to retry.

Authenticate with Authorization: Bearer <API key or OAuth access token>; keys need the summarization:process scope. Every error has the body {"error": {"code", "message", "request_id"}}.