Object revisions

List an Object's revisions

Retrieve the version history of an Object, newest first by default. Revisions are immutable.

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

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.

sort'created_at' | '-created_at'

Sort order. Prefix with - for descending.

limitinteger

Maximum number of results to return.

skipinteger

Offset pagination: number of results to skip. Use after instead for large collections. Only one of skip and after may be used.

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 Object's revisions.

totalinteger
limitinteger

Changes

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