Appearance
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
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
}
}