Skip to content
On this page

Revisions

Revisions are individual changes to items made. Directus keeps track of changes made, so you're able to revert to a previous state at will. Learn more about Revisions.


The Revision Object

id integer
Primary key of the revision.

activity many-to-one
Related activity record. Many-to-one to activity.

collection string
Collection in which this revision happened.

item string
Primary key of the item that was changed.

data object
Snapshot of the top-level item data.

delta object
Snapshot of the changes made in this revision.

parent many-to-one
Parent revision that triggered this revision. Many-to-one to revisions (recursive).

json
{
	"id": 368,
	"activity": 438,
	"collection": "articles",
	"item": "1",
	"data": {
		"title": "Hello World"
	},
	"delta": {
		"title": "Hello from the Docs!"
	},
	"parent": null
}

List revisions

List all revisions that exist in Directus.

Permissions

The data returned in this endpoint will be filtered based on the user's permissions. For example, revisions that apply to a collection that the current user doesn't have access to are stripped out.

Query Parameters

Supports all global query parameters.

Returns

An array of up to limit revision objects. If no items are available, data will be an empty array.

REST API

GET /revisions
SEARCH /revisions

Learn more about SEARCH ->

GraphQL

POST /graphql/system
graphql
type Query {
	revisions: [directus_revisions]
}
Examples
graphql
query {
	revisions {
		id
		data
		delta
	}
}

Retrieve a revision

List an existing revision by primary key.

Query Parameters

Supports all global query parameters.

Returns

Returns the requested revision object.

REST API

GET /revisions/:id
Example
GET /revisions/322

GraphQL

POST /graphql/system
graphql
type Query {
	revisions_by_id(id: ID!): directus_revisions
}
Example
graphql
query {
	revisions_by_id(id: 322) {
		id
		data
		delta
	}
}