Skip to content
Return to top
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
    	}
    }