Get a Generation
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.
Authorization
apiKey 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
Unique identifier for a generation.
^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"}Delete a Delivery DELETE
Removes a Delivery from its Target. Removing a repository Delivery retires the Target's open Draft pull request; removing a hosted MCP Delivery stops serving its URL. Recreating the type later allocates a new ID and, for hosted MCP, a new URL. A `409 target_busy` means the Target is publishing; wait for it to finish. A `502 follow_up_failed` means the Delivery was removed, but retiring an obsolete review or regenerating the Target failed. See [conditional writes](https://typeship.dev/docs/typeship-api#conditional-writes) for ETag and If-Match.
List Generations GET
Next Page