817ccf3620
* Add Quickstart Guide * Update installation * Remove unused files * Update support/backing * Tweaks in concepts * Setup file structure for API reference 2.0 * Setup page layout for reference * Add clean-urls plugin * getting started updates * Finish authentication rest * getting started updates * Render stylus in 2 spaces * Various * Various * Finish activity docs * Add collections reference * Add extension reference * concepts updates * Fields/tweaks * Add files doc * Add revisions * concepts docs * More api reference * Finish rest api reference (finally) * initial concepts * More things * Add assets api ref * Move sections from file to assets * Add environment variables * contributing docs * Add field transforms page * Left align table headers * concept links * Add API config * Fix mobile nav * Add migrating a project * doc link fixes Co-authored-by: Ben Haynes <ben@rngr.org>
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.
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
}
}