DocumentationCLIMCPSDKsAPI Reference
Console
Projects

List a project's generations

GET
/projects/{project_id}/generations

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

project_id*string

Unique identifier for a project.

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

Query Parameters

limit?integer

Maximum number of resources to return.

Range1 <= value <= 100
Default20
cursor?string

Opaque cursor from the preceding page's next_cursor.

target_id?string

Only generations for this persisted Target.

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

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/projects/prj_4f8k2m7x9q1v6b3n/generations"
{  "object": "list",  "data": [    {      "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"    }  ],  "has_more": true,  "next_cursor": "string"}

Generate targets and open pull requests POST

Resolves the project's URL or GitHub source, generates every configured delivery package, stores each result in the project's history, and attempts to open a pull request in every configured destination. When the complete generated tree already matches a destination, no commit, branch, or pull request is created and that generation reports `pr_status: no_changes`. This is the same pipeline automatic regeneration runs after a source change.

List a project's Targets GET

Next Page