DocumentationTypeship CLITypeship MCPTypeship SDKsAPI Reference
Console
Generations

List a Generation's files

GET
/generations/{generation_id}/files

Lists the generated package's files, ordered by path. Read content with getFile.

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}$

Query Parameters

limit?integer

Maximum number of resources to return. Omit for 20; otherwise supply base-10 digits representing an integer from 1 to 100. Empty, malformed, or out-of-range values return 400 invalid_request. List query parameters must appear only once; unrecognized parameters also return 400.

Range1 <= value <= 100
Default20
cursor?string

Opaque cursor from the preceding page's next_cursor. Valid only for the same organization, operation, filters, and ordering that issued it. Omit to start at the first page. Empty, malformed, or repeated cursors return 400 invalid_request. The page limit may change between requests.

Match^[A-Za-z0-9_-]+$
Length1 <= length <= 2048

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/generations/gen_7h2p5d9c3m8w1k6q/files"
{  "object": "list",  "data": [    {      "id": "file_7n3q9v2k5m8d1h4c",      "object": "file",      "path": "README.md",      "size_bytes": 66,      "sha256": "2c26b46b68ffc68ff99b453c1d30413413422d706483bfa0f98a5e886266e7ae",      "encoding": "utf8",      "mode": "100644",      "created_at": "2026-09-23T08:05:00Z"    }  ],  "has_more": false,  "next_cursor": null,  "request_id": "req_3k8m1v6q9p2d7h4c"}

Get a generation GET

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.

List Spec Revisions GET

Lists Spec Revisions, newest first. Source content is not included; list a revision's files with listSpecRevisionFiles.