Audit Events API (PREMIUM)

Introduced in GitLab 12.4.

Instance Audit Events (PREMIUM SELF)

The Audit Events API allows you to retrieve instance audit events. This API cannot retrieve group or project audit events.

To retrieve audit events using the API, you must authenticate yourself as an Administrator.

Retrieve all instance audit events

GET /audit_events

Attribute	Type	Required	Description
`created_after`	string	no	Return audit events created on or after the given time. Format: ISO 8601 (`YYYY-MM-DDTHH:MM:SSZ`)
`created_before`	string	no	Return audit events created on or before the given time. Format: ISO 8601 (`YYYY-MM-DDTHH:MM:SSZ`)
`entity_type`	string	no	Return audit events for the given entity type. Valid values are: `User`, `Group`, or `Project`.
`entity_id`	integer	no	Return audit events for the given entity ID. Requires `entity_type` attribute to be present.

By default, GET requests return 20 results at a time because the API results are paginated.

Retrieve single instance audit event

GET /audit_events/:id

Attribute	Type	Required	Description
`id`	integer	yes	The ID of the audit event

curl --header "PRIVATE-TOKEN: <your_access_token>" "https://primary.example.com/api/v4/audit_events/1"

Example response:

{
  "id": 1,
  "author_id": 1,
  "entity_id": 6,
  "entity_type": "Project",
  "details": {
    "custom_message": "Project archived",
    "author_name": "Administrator",
    "target_id": "flightjs/flight",
    "target_type": "Project",
    "target_details": "flightjs/flight",
    "ip_address": "127.0.0.1",
    "entity_path": "flightjs/flight"
  },
  "created_at": "2019-08-30T07:00:41.885Z"
}

Group Audit Events

Introduced in GitLab 12.5.

Support for keyset pagination added in GitLab 15.2.

The Group Audit Events API allows you to retrieve group audit events. This API cannot retrieve project audit events.

A user with a Owner role (or above) can retrieve group audit events of all users. A user with a Developer or Maintainer role is limited to group audit events based on their individual actions.

This endpoint optionally supports keyset pagination:

When requesting consecutive pages of results, we recommend you use keyset pagination.

Retrieve all group audit events

GET /groups/:id/audit_events

Attribute	Type	Required	Description
`id`	integer/string	yes	The ID or URL-encoded path of the group
`created_after`	string	no	Return group audit events created on or after the given time. Format: ISO 8601 (`YYYY-MM-DDTHH:MM:SSZ)`
`created_before`	string	no	Return group audit events created on or before the given time. Format: ISO 8601 (`YYYY-MM-DDTHH:MM:SSZ`)

By default, GET requests return 20 results at a time because the API results are paginated.

Retrieve a specific group audit event

Only available to group owners and administrators.

GET /groups/:id/audit_events/:audit_event_id

Attribute	Type	Required	Description
`id`	integer/string	yes	The ID or URL-encoded path of the group
`audit_event_id`	integer	yes	The ID of the audit event

curl --header "PRIVATE-TOKEN: <your_access_token>" "https://primary.example.com/api/v4/groups/60/audit_events/2"

Example response:

{
  "id": 2,
  "author_id": 1,
  "entity_id": 60,
  "entity_type": "Group",
  "details": {
    "custom_message": "Group marked for deletion",
    "author_name": "Administrator",
    "target_id": "flightjs",
    "target_type": "Group",
    "target_details": "flightjs",
    "ip_address": "127.0.0.1",
    "entity_path": "flightjs"
  },
  "created_at": "2019-08-28T19:36:44.162Z"
}

Project Audit Events

Introduced in GitLab 13.1.

The Project Audit Events API allows you to retrieve project audit events.

A user with a Maintainer role (or above) can retrieve project audit events of all users. A user with a Developer role is limited to project audit events based on their individual actions.

Retrieve all project audit events

GET /projects/:id/audit_events

Attribute	Type	Required	Description
`id`	integer/string	yes	The ID or URL-encoded path of the project
`created_after`	string	no	Return project audit events created on or after the given time. Format: ISO 8601 (`YYYY-MM-DDTHH:MM:SSZ`)
`created_before`	string	no	Return project audit events created on or before the given time. Format: ISO 8601 (`YYYY-MM-DDTHH:MM:SSZ`)

By default, GET requests return 20 results at a time because the API results are paginated.

Retrieve a specific project audit event

Only available to users with at least the Maintainer role for the project.

GET /projects/:id/audit_events/:audit_event_id

Attribute	Type	Required	Description
`id`	integer/string	yes	The ID or URL-encoded path of the project
`audit_event_id`	integer	yes	The ID of the audit event

curl --header "PRIVATE-TOKEN: <your_access_token>" "https://primary.example.com/api/v4/projects/7/audit_events/5"

Example response:

{
  "id": 5,
  "author_id": 1,
  "entity_id": 7,
  "entity_type": "Project",
  "details": {
      "change": "prevent merge request approval from committers",
      "from": "",
      "to": "true",
      "author_name": "Administrator",
      "target_id": 7,
      "target_type": "Project",
      "target_details": "twitter/typeahead-js",
      "ip_address": "127.0.0.1",
      "entity_path": "twitter/typeahead-js"
  },
  "created_at": "2020-05-26T22:55:04.230Z"
}