List Definition Revisions
Immutable snapshots of the complete resolved document graph this Definition observed, newest first. Content is available from the revision and document endpoints and is never embedded in a list response.
Immutable snapshots of the complete resolved document graph this Definition observed, newest first. Content is available from the revision and document endpoints and is never embedded in a list response.
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
Path Parameters
Unique identifier for a project's logical API Definition.
^def_[a-z0-9]{16}$Query Parameters
Maximum number of resources to return.
1 <= value <= 10020Opaque cursor from the preceding page's next_cursor.
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/definitions/def_2p8m4q7k1v9d6h3c/revisions"{ "object": "list", "data": [ { "id": "drev_6m1q8v4k2p9d7h3c", "object": "definition_revision", "project_id": "prj_4f8k2m7x9q1v6b3n", "definition_id": "def_2p8m4q7k1v9d6h3c", "format": "openapi", "document_count": 1, "documents": [ { "id": "doc_8q2m5v1k9p4d7h3c", "role": "entrypoint", "coordinate": "string", "sha256": "string", "size_bytes": 0 } ], "sha256": "9f86d081884c7d659a2feaa0c55ad015a3bf4f1b2b0b822cd15d6c15b0f00a08", "size_bytes": 0, "source": { "kind": "url", "url": "http://example.com" }, "created_at": "2019-08-24T14:15:22Z" } ], "has_more": true, "next_cursor": "string"}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.
Retrieve a Definition Revision GET
Metadata for one immutable resolved document graph. Fetch its canonical content or individual source documents from the content endpoints.