Developer API (2.0.0)

Download OpenAPI specification:Download

Audit Log

Operations about audit logs.

List audit logs

This endpoint requires the following permission(s): project_configuration:audit_logs:read. This endpoint belongs to the Project Configuration domain, which has a default rate limit of 60 requests per minute.

Authorizations:

BearerAuth

path Parameters

project_id

required

string <= 255 characters

Example: proj1ab2c3d4

ID of the project

query Parameters

starting_after	string Example: starting_after=log1ab2c3d4e5 Cursor for pagination. Returns audit logs after the specified audit log ID, using descending order by audit log ID.
start_date	string <date> Example: start_date=2024-01-01 Start date for the data range (ISO 8601 format)
end_date	string <date> Example: end_date=2024-12-31 End date for the data range (ISO 8601 format)
limit	integer Default: 20 Example: limit=10 Maximum number of items to return per page. Values below 1 or above 100 are clamped to that range rather than rejected.

Responses

Response samples

Content type

application/json

{"object": "list",
"items": [{"object": "audit_log",
"id": "log1ab2c3d4e5",
"project_id": "proj1ab2c3d4",
"action_type": "project_name_updated",
"target_type": "project",
"target_identifier": "proj1ab2c3d4",
"actor_type": "user",
"actor_identifier": "user_abc123",
"occurred_at": 1713297600000,
"additional_data": { }
}
],
"next_page": "/v2/projects/proj1ab2c3d4/audit_logs?starting_after=log1ab2c3d4e5",
"url": "/v2/projects/proj1ab2c3d4/audit_logs"
}