List the audit log of one cluster

GET /org/clusters/{cluster_id}/audit-logs

List the audit log of one cluster

Python

import requests

url = "https://platform.ankra.app/org/clusters/{cluster_id}/audit-logs"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

200

{
  "items": [
    {
      "action_type": "<string>",
      "actor": {
        "agent_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "agent_name": "<string>",
        "autonomy": "<string>",
        "email": "<string>",
        "origin": "<string>",
        "run_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "session_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "trigger": "<string>",
        "type": "agent"
      },
      "cluster_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "cluster_is_deleted": true,
      "cluster_name": "<string>",
      "details": {},
      "ip_address": "<string>",
      "log_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "outcome": {
        "duration_ms": 123,
        "error": "<string>",
        "status": "succeeded"
      },
      "resource_id": "<string>",
      "resource_type": "<string>",
      "target": {
        "kind": "<string>",
        "name": "<string>",
        "namespace": "<string>"
      },
      "timestamp": "2023-11-07T05:31:56Z",
      "user_email": "<string>",
      "user_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
    }
  ],
  "page": 123,
  "page_size": 123,
  "total": 123,
  "total_pages": 123
}

Authorizations

Authorization · string · header · required

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

Path Parameters

cluster_id · string<uuid> · required

Query Parameters

page · integer · default: 1

page_size · integer · default: 50

Required range: x <= 200

search · string

user_id · string<uuid>

action_type · string

resource_type · string

start_date · string<date-time>

end_date · string<date-time>

actor_type · enum<string>

Available options: agent, human, system

outcome · enum<string>

Available options: succeeded, failed

agent_task_id · string<uuid>

Response

200

application/json

One cluster's slice of the organisation audit trail, newest first.

items · object[] · required

Show child attributes

page · integer · required

page_size · integer · required

total · integer · required

total_pages · integer · required