v1

latestOpenAPI 3.1.02026-07-26157321426.3 KB

Gets the audit log for the workspace

Returns audit-log entries across the workspace, newest first, covering models, chains, and workspace-level actions. Use the filters to narrow by event type, actor, resource, environment, source, or time window, and the cursor to page. In workspaces with multiple teams, only organization admins can read the workspace audit log.

get/v1/audit_logs

Query parameters

cursorstring nullable

Opaque cursor returned by a previous page. Omit to fetch the first page.

limitinteger

Maximum number of entries to return per page. Defaults to 20, and must be between 1 and 200.

direction'DESC' | 'ASC'

Sort order of returned entries, by creation time.

Sort order by the time the action occurred. Defaults to DESC (newest first). Ignored when paginating with a cursor.

searchstring nullable

Case-insensitive substring matched against resource names and IDs in the entry.

event_type_groupsAuditLogEventTypeGroupV1[]

When set, returns only entries whose event type falls in one of these groups.

user_idsstring[]

When set, returns only entries whose acting user is one of these IDs.

deployment_idsstring[]

When set, returns only entries referencing one of these model deployment IDs.

chain_deployment_idsstring[]

When set, returns only entries referencing one of these chain deployment IDs.

environment_namesstring[]

When set, returns only entries for one of these environments.

sourcesAuditLogSourceV1[]

When set, returns only entries issued from one of these surfaces.

start_epoch_millisinteger nullable

Epoch milliseconds for the start of the window. Defaults to the beginning of the audit-log history.

end_epoch_millisinteger nullable

Epoch milliseconds for the end of the window. Defaults to the current time.

Response