List releases
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
Query Parameters
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.
1 <= value <= 10020Opaque 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.
^[A-Za-z0-9_-]+$1 <= length <= 2048Only releases of this Target.
^tgt_[a-z0-9]{16}$Response Body
application/json
application/json
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/releases"{ "object": "list", "data": [ { "id": "rel_7m2q8v4k1p9d5h6c", "object": "release", "target_id": "tgt_5m8q2v7k1p9d4h6c", "generation_id": "gen_7h2p5d9c3m8w1k6q", "version": "1.0.0", "channel": "stable", "origin": "typeship", "repository": { "provider": "github", "identifier": "parcel-example/parcel-client" }, "spec_revision_id": "srev_6m1q8v4k2p9d7h3c", "commit_sha": "0123456789abcdef0123456789abcdef01234567", "checks": [], "approvals": [], "import_provenance": null, "publications": [], "created_at": "2026-09-23T08:00:00Z" } ], "has_more": false, "next_cursor": null, "request_id": "req_3k8m1v6q9p2d7h4c"}Approve recovery from rewritten default-branch history POST
When the Draft has status `action_required` and reason `history_rewritten`, review affected files with `listDraftFiles` and `filter=history`, then approve with the Draft's `history_recovery` revisions. Approval saves the recovery without changing Git and returns the Draft; the next generation rebuilds it from the rewritten default branch. The previous Draft branch stays available, and overlapping code comes back as conflicts to resolve. A rewritten Draft branch alone needs no approval.
Get an immutable release GET
Next Page