2.6 KiB
pageClass
| pageClass |
|---|
| page-reference |
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).
{
"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.
::: tip 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.
GET /revisions
// Response
{
"data": [
{
"id": 368,
"activity": 438,
"collection": "articles",
"item": "1",
"data": {
"title": "Hello World"
},
"delta": {
"title": "Hello from the Docs!"
},
"parent": null
},
{...},
{...}
]
}
Retrieve a revision
List an existing revision by primary key.
Query Parameters
Supports all global query parameters.
Returns
Returns the requested revision object.
GET /revisions/:id
// Response
{
"data": {
"id": 368,
"activity": 438,
"collection": "articles",
"item": "1",
"data": {
"title": "Hello World"
},
"delta": {
"title": "Hello from the Docs!"
},
"parent": null
}
}