List Spec Revisions
Lists Spec Revisions, newest first. Source content is not included; list a revision's files with listSpecRevisionFiles.
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 revisions of this Spec.
^spec_[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/spec-revisions"{ "object": "list", "data": [ { "id": "srev_6m1q8v4k2p9d7h3c", "object": "spec_revision", "project_id": "prj_4f8k2m7x9q1v6b3n", "spec_id": "spec_2p8m4q7k1v9d6h3c", "format": "openapi", "file_count": 1, "files": [ { "path": "/openapi.json", "role": "entrypoint", "sha256": "3ccd2685803ba4c4db9bed78c3ef8d1993e119abbdafa1ab5dfa6d31846da05d", "size_bytes": 524 } ], "sha256": "3ccd2685803ba4c4db9bed78c3ef8d1993e119abbdafa1ab5dfa6d31846da05d", "size_bytes": 524, "source": { "type": "url", "url": { "url": "https://api.parcel.example/openapi.json" } }, "created_at": "2026-09-23T08:00:00Z" } ], "has_more": false, "next_cursor": null, "request_id": "req_3k8m1v6q9p2d7h4c"}List a Generation's files GET
Lists the generated package's files, ordered by path. Read content with getFile.
Get a Spec Revision GET
Returns metadata for a saved Spec Revision with a Diagnostics summary. Pass `include=diagnostics` to add every Diagnostic, evaluated with the Spec's current patches and Diagnostic policy. List its source files and resolved document with listSpecRevisionFiles.