For the complete documentation index, see llms.txt. This page is also available as Markdown.

GET /agent/generations/{generationId}

Poll an agent generation until status is completed or failed.

Poll an agent generation job until status is completed or failed: a completed response carries the gamma's id and URL, the agent's result.summary, and any exportUrl; a failed one carries error; both report credits.deducted / credits.remaining when the lookups succeed. While the job is still pending, optional progress reports card counts and an estimated completion percentage once the agent starts building cards. Agent generation ids are prefixed with gen_.

Get agent generation status

get

Retrieves the current status of an agent generation. Poll this endpoint until status is "completed" or "failed". The gamma object can appear on a pending generation once the document has been created.

Authorizations
X-API-KEYstringRequired

API key for authentication

Path parameters
generationIdstring · max: 128Required

The generation id returned by POST /v1.0/agent/generations. Agent generation ids are prefixed gen_.

Example: gen_V1StGXR8Z5jdHi6BPattern: ^gen_[A-Za-z0-9]+$
Responses
200

Generation status retrieved successfully

application/json
or
or
get/v1.0/agent/generations/{generationId}
GET /v1.0/agent/generations/{generationId} HTTP/1.1
Host: public-api.gamma.app
X-API-KEY: YOUR_API_KEY
Accept: */*
{
  "generationId": "gen_V1StGXR8Z5jdHi6B",
  "status": "pending",
  "gamma": {
    "gammaId": "g_5hzkx0ivxsmd2ep",
    "gammaUrl": "https://gamma.app/docs/q7w2m4n8r1t6y3u"
  },
  "progress": {
    "stages": {
      "writing": 3,
      "checking": 3,
      "done": 4
    },
    "done": 4,
    "total": 10,
    "percent": 69
  },
  "warnings": [],
  "updatedTime": "2026-08-25T17:01:12.000Z"
}

The gamma object can appear while the job is still pending, once the document has been created. Optional progress (done, total, percent, and per-stage counts in stages) can appear once card building starts; percent runs from 0 to 99 and only completed means 100%. Keep polling until status is completed or failed. See Poll for results for pacing and rate limit headers.

Last updated

Was this helpful?