Revisions

Access item revision history

Revisions track changes made to items over time.

List Revisions

Retrieve all revisions for an item.

GET /revisions

Filter by collection and item:

GET /revisions?filter[collection][_eq]=articles&filter[item][_eq]=1

Get Revision

Retrieve a specific revision.

GET /revisions/:id

Example:

curl "https://your-directus-instance.com/revisions/123" \
  -H "Authorization: Bearer YOUR_TOKEN"

Revision Properties

id · integer

Revision ID

collection · string

Collection name

item · string

Item ID

data · object

Item data at this revision

delta · object

Changes made in this revision

activity · integer

Related activity log ID

Item Revisions

Get revisions for a specific item:

GET /items/:collection/:id/revisions

Example:

curl "https://your-directus-instance.com/items/articles/1/revisions" \
  -H "Authorization: Bearer YOUR_TOKEN"

Revert to Revision

To revert an item to a previous revision, update the item with the revision’s data:

PATCH /items/:collection/:id

With the data from the revision as the request body.

Next Steps

Activity

View activity logs

Items

Manage items