Activity

All events that happen within Directus are tracked and stored in the activities collection. This gives you full accountability over everything that happens.

List Activity Actions

Returns a list of activity actions.

Query Parameters

fields
array

Control what fields are being returned in the object.

limit
integer

A limit on the number of objects that are returned.

meta
string

What metadata to return in the response.

offset
integer

How many items to skip when fetching data.

sort
array

How to sort the returned items. sort is a CSV of fields used to sort the fetched items. Sorting defaults to ascending (ASC) order but a minus sign (-) can be used to reverse this to descending (DESC) order. Fields are prioritized by their order in the CSV. You can also use a ? to sort randomly.

filter

Select items in collection by given conditions.

search
string

Filter by items that contain the given search query in one of their fields.

Response

Successful request

data
array
meta
object
GET /activity
Response Example
{
  "data": [
    {
      "id": 2,
      "action": "update",
      "timestamp": "2019-12-05T22:52:09Z",
      "ip": "127.0.0.1",
      "user_agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_1) AppleWebKit/537.36 (KHTML,like Gecko) Chrome/78.0.3904.108 Safari/537.36",
      "item": "328",
      "comment": null,
      "origin": "https://directus.io",
      "revisions": []
    }
  ],
  "meta": {}
}

Retrieve an Activity Action

Returns a single activity action by primary key.

Query Parameters

id
integer

Identifier for the object.

fields
array

Control what fields are being returned in the object.

meta
string

What metadata to return in the response.

Response

Successful request

data
object
GET /activity/{id}
Response Example
{
  "data": {
    "id": 2,
    "action": "update",
    "timestamp": "2019-12-05T22:52:09Z",
    "ip": "127.0.0.1",
    "user_agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_1) AppleWebKit/537.36 (KHTML,like Gecko) Chrome/78.0.3904.108 Safari/537.36",
    "item": "328",
    "comment": null,
    "origin": "https://directus.io",
    "revisions": []
  }
}