Generations

Get a generation

GET
/generations/{generation_id}

Returns the status of that Generation. queued and running mean generation is still in progress. completed means generated files are saved, not that repository delivery or a Draft is complete. List its files with listGenerationFiles and read each with getFile.

AuthorizationBearer <token>

Organization API key from the console (ak_...), or an OAuth access token with user:org:read, the organization selected during consent, and the capability required by the operation.

In: header

Path Parameters

generation_id*string

Unique identifier for a generation.

Match^gen_[a-z0-9]{16}$

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/generations/gen_7h2p5d9c3m8w1k6q"
{  "id": "gen_7h2p5d9c3m8w1k6q",  "object": "generation",  "project_id": "prj_4f8k2m7x9q1v6b3n",  "spec_revision_id": "srev_6m1q8v4k2p9d7h3c",  "status": "completed",  "trigger": "manual",  "target_id": "tgt_5m8q2v7k1p9d4h6c",  "type": "cli",  "name": "parcel-cli",  "version": "1.0.0",  "warnings": [],  "coverage": {    "generated": 12,    "omitted": 0,    "total": 12,    "omitted_operations": []  },  "file_count": 1,  "errors": [],  "runtime_ms": 4200,  "created_at": "2026-09-23T08:00:00Z",  "updated_at": "2026-09-23T08:00:00Z",  "request_id": "req_3k8m1v6q9p2d7h4c"}