Generations
Retrieve a generation
Includes the generated files when the generation succeeded.
Includes the generated files when the generation succeeded.
Authorization
apiKey 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
curl -X GET "https://example.com/generations/gen_7h2p5d9c3m8w1k6q"{ "id": "gen_7h2p5d9c3m8w1k6q", "object": "generation", "project_id": "prj_4f8k2m7x9q1v6b3n", "definition_revision_id": "drev_6m1q8v4k2p9d7h3c", "status": "succeeded", "trigger": "manual", "target_id": "tgt_5m8q2v7k1p9d4h6c", "generator": "typescript-sdk", "provenance": { "generator_edition": "2026-08-24", "engine_build": "abc123", "resolved_config": null, "config_hash": null, "surface_plan": null, "surface_plan_hash": null, "entitlement_cap": null, "package_version": "1.0.0" }, "meta": { "title": "Acme Payments API", "api_version": "1.0.0", "version": "1.0.0", "oas_version": "3.1", "artifact_name": "@acme/payments", "client_name": "AcmeClient", "generators": [ "typescript-sdk" ] }, "warnings": [], "error": null, "created_at": "2026-01-01T00:00:00Z"}Update and resolve a Definition PATCH
Resolves the complete document graph and records a new immutable revision before saving.
Fetch one file from a generation GET
Raw file content, for generations whose target was too large to inline (files_omitted true). The generation's files_index lists valid paths.