List Audit Entries | HiddenLayer Documentation

curl -G https://api.hiddenlayer.ai/audit/v3/entries \
     -H "Authorization: Bearer <token>" \
     --data-urlencode start_time=2025-05-27T00:00:00Z \
     --data-urlencode end_time=2025-05-27T23:59:59Z \
     -d actor_type=API_KEY

{
  "items": [
    {
      "occurred_at": "2025-05-27T00:00:00Z",
      "action": "delete",
      "resource_type": "model",
      "resource_id": "fb0eb4e3-6cd7-488b-981c-619b2c707ab9",
      "api_permissions_required": [
        "model:delete"
      ],
      "actor_type": "USER",
      "actor_id": "e4341229-9bb0-4336-84a6-4ca50c959369",
      "assigned_roles": [
        "org-admin"
      ],
      "metadata": {
        "model_name": "gpt-3.5-turbo"
      },
      "description": "deleted model",
      "actor_email": "john.doe@example.com"
    },
    {
      "occurred_at": "2025-05-24T00:00:00Z",
      "action": "create",
      "resource_type": "model",
      "resource_id": "fb0eb4e3-6cd7-488b-981c-619b2c707ab9",
      "api_permissions_required": [
        "model:create"
      ],
      "actor_type": "USER",
      "actor_id": "81ae1941-501e-48db-81db-49bf61c6fe8f",
      "assigned_roles": [
        "analyst"
      ],
      "metadata": {
        "model_name": "gpt-3.5-turbo",
        "model_version": "1.0",
        "model_source": "Local"
      },
      "description": "Created model",
      "actor_email": "john.doe@example.com"
    }
  ],
  "limit": 10,
  "offset": 0
}

Returns audit log entries for the tenant, sorted by time with the most recent first. Results can be filtered by time range, actor, role, action, and resource type, or searched by free text.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Query parameters

start_timedatetimeOptional

Filter audit entries by time range

end_timedatetimeOptional

Filter audit entries by time range

rolestringOptional

Filter audit entries by role

actionstringOptional

Filter audit entries by action

resource_typestringOptional

Filter audit entries by resource_type

actor_typeenumOptional

Filter audit entries by actor_type

Allowed values:

searchstringOptional

Search for audit entries by text (searches user, role, action, resource type)

limitintegerOptional1-100Defaults to 25

offsetintegerOptional>=0Defaults to 0

Response

Successful response

itemslist of objects

List of items. If no matching items are found, then [] will be returned.

limitinteger1-100Defaults to 25

Maximum number of items to return

offsetinteger>=0Defaults to 0

Begin returning the results from this offset

Errors

400

Bad Request Error

422

Unprocessable Entity Error