API reference · Audit logs
Get an audit log entry
/v1/orgs/{org_id}/audit-logs/{audit_log_id}Returns one entry with the request that made the change. Changes made by platform operators show the actor as "Platform operator", without their identity, address or reason.
Console session only: no API key can be granted the audit_log:read permission it needs. Requires the audit_log:read permission (a key's scope, or a role that includes it).
Request
Path parameters
org_idstringYour organization. The SDKs and the CLI fill it in from the API key.
ID with prefix org_
audit_log_idstringrequiredID of the audit log
ID with prefix aud_
Response
200 AuditLogEntry — The entry
objectstringrequiredAlways `audit_log_entry`: the type of this object
One of
audit_log_entryidstringrequiredUnique ID (`aud_…`)
ID with prefix aud_
org_idstring | nullrequiredOrganization it belongs to
project_idstring | nullrequiredProject it belongs to
actorobjectrequiredWho made the change
ShowHide 4 fields of
actortypestringrequiredFiner kind of actor than `kind`: `user` or `playground` (a member, directly or through the console playground), `api_key`, `operator` (a platform operator) or the type of a platform component
idstringrequiredThe member’s user ID, the API key ID or the component; `platform` for every platform operator
kindstringrequired`member` (a person in the org), `api_key`, `platform` (a platform operator, never named) or `system` (the platform itself: billing enforcement, sign-in checks, the payment processor)
One of
memberapi_keyplatformsystemnamestring | nullrequiredWho it was when the entry was written: a member’s name or an API key’s name. Kept after the member leaves or the key is revoked or renamed.
actionstringrequiredWhat was done, as `resource:verb`
targetobjectrequiredThe resource the change was made to
ShowHide 2 fields of
targettypestring | nullrequiredKind of resource the change was made to (null when there is none)
idstring | nullrequiredUnique ID
metadataobject | nullrequiredYour own key/value labels, returned as given
requestobjectrequiredThe API request that made the change (all null when none)
ShowHide 4 fields of
requestidstring | nullrequiredUnique ID
methodstring | nullrequiredHTTP method
routestring | nullrequiredRoute that handled it, with path parameters as placeholders
statusinteger | nullrequiredHTTP status code of the response
ipstring | nullrequiredIP address the change came from (null when unknown or made by the platform)
user_agentstring | nullrequiredUser-Agent header of the request (null when none)
created_atstring (date-time)requiredWhen it was created (ISO 8601, UTC)
Example response
{
"object": "audit_log_entry",
"id": "aud_01jc5zq4m8k3v6x9t2w7r0b1e4",
"org_id": "string",
"project_id": "string",
"actor": {
"type": "string",
"id": "string",
"kind": "member",
"name": "Ada Lovelace"
},
"action": "api_key:create",
"target": {
"type": "api_key",
"id": "string"
},
"metadata": {},
"request": {
"id": "string",
"method": "POST",
"route": "string",
"status": 1
},
"ip": "string",
"user_agent": "string",
"created_at": "2026-01-01T00:00:00.000Z"
}Errors
Errors use the standard envelope. What this operation can answer:
| Status | Type | When |
|---|---|---|
400 | invalid_request_error | A parameter or body field is missing or not allowed; param names it. |
401 | authentication_error | The key or session is missing, revoked or expired. |
403 | permission_error | The credential lacks the permission this needs, or the organization is suspended. |
404 | not_found_error | No such resource in this project (an ID from another project is answered the same way). |
429 | rate_limit_error rate_limited | Too many requests; retry after retry-after seconds. |