v1

latestOpenAPI 3.1.02026-07-26157321426.3 KB

Gets the audit log for a model

Returns audit-log entries for a single model, newest first. Use the filters to narrow by event type, actor, deployment, environment, source, or time window, and the cursor to page.

get/v1/models/{model_id}/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