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_.
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.
API key for authentication
The generation id returned by POST /v1.0/agent/generations.
Agent generation ids are prefixed gen_.
gen_V1StGXR8Z5jdHi6BPattern: ^gen_[A-Za-z0-9]+$Generation status retrieved successfully
Invalid request parameters
Invalid or missing API key
Generation not found
Rate limit exceeded
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"
}Related
POST /agent/generations to start a new agent generation
Poll for results for complete polling implementations
GET /gammas/{gammaId} for metadata after you have a
gammaId
Last updated
Was this helpful?