Audit Logs

List organization audit logs

Retrieve audit logs for a specific organization with optional filtering and pagination.

get/organizations/{orgId}/audit-logs

Query parameters

startTimestring date-time
Example:2023-01-01T00:00:00Z

Start time for filtering audit logs (ISO 8601 format)

endTimestring date-time
Example:2023-12-31T23:59:59Z

End time for filtering audit logs (ISO 8601 format)

cursorstring

The position in the result list to start from when fetching paginated results. For details, see Pagination.

limitinteger

Defaults to 20

The maximum number of audit log items to return. For details, see Pagination.

Parameters

#/paths/~1logs/get/parameters/3 — unresolved $ref

Response

OK

cursorstring required

Example response

[
  {
    "auditLog": {
      "id": "aud-123456789",
      "timestamp": "2023-10-01T12:00:00Z",
      "event": "CreateServerEvent",
      "status": "success",
      "actor": {
        "type": "user",
        "email": "user@example.com",
        "id": "usr-123456789"
      },
      "metadata": {
        "service": "srv-123456789",
        "field": "env_vars"
      }
    }
  }
]

Changes