Object revisions

Get a single revision

Retrieve one revision of an Object by its id, including the metadata values as they were at that point in history.

get/buckets/{slug}/objects/{object_id}/revisions/{revision_id}

Query parameters

read_keystring

The Bucket read key. Required unless the Bucket has no read key configured.

preview_tokenstring

A short-lived JWT issued by the Cosmic dashboard (object editor > Preview). When present and valid, the request is treated as status=any so the latest draft is returned. Bound to one Bucket for one hour. Still requires read_key. Invalid or expired tokens return 401.

propsstring

Comma-separated list of properties to return, including nested metadata paths. Omit to return everything. Narrowing props is the main way to keep responses under the 6 MB response cap and to reduce latency.

useCacheboolean

Set to false to bypass the cache and read through to the database. Guarantees you see writes you just made, at the cost of higher latency.

prettyboolean

Set to true to indent the JSON response for human reading. Increases response size.

Response

The requested revision.

Changes

No recorded changes to this endpoint across all 1 revision of this API.