List audit events
List audit events for the organization. Rows leave out some detailed payload fields; get the event for its full payload.
List audit events for the organization. Rows leave out some detailed payload fields; get the event for its full payload.
ApiKeyAuthAuthorizationBearer <token>Bearer token authentication. Send an API key (a saai_api_-prefixed token) as Authorization: Bearer <token>.
Required permission
view_auditaction?array<>action_not?array<>mcp_id?array<>mcp_id_not?array<>agent_instance_id?array<>agent_instance_id_not?array<>agent_slug?array<string>agent_slug_not?array<string>user_id?array<>user_id_not?array<>scope?stringown returns only the caller's own records, even when they may see the whole organization. all, the default, returns everything the caller may see. It never widens what the caller may see.
"all""own"user_group?array<string>user_group_not?array<string>agent_tag_id?array<>resource_tag_id?array<>connection_id?stringuuidpolicy_id?stringuuidrule_id?array<>Only events any of these rules acted on, matched against resources.rules.
rule_id_not?array<>Leave out events any of these rules acted on; events no rule acted on are kept.
session_key?stringOnly model calls in this client session or conversation, as recorded in resources.session_key.
autonomous?booleanOnly events by autonomous agents when true, only by user-bound agents when false. Events with no recorded mode never match.
start_time?stringInclusive lower bound; events with a timestamp >= start_time. Defaults to 30 days ago when omitted.
date-timeend_time?stringExclusive upper bound; events with a timestamp < end_time. Defaults to now when omitted.
date-timecursor?stringA UUIDv7, the id of a row in a time-partitioned table, which rejects any other version.
^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-7[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$uuidlimit?integerint321 <= value <= 10020The request has succeeded.
application/json- response
items*array<>next_cursor?uuiduuidcurl -X GET 'https://your-org.aisecurity.services.us.connect.secureauth.com/api/v1/audit-events'{ "items": [ { "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "org_id": "a40f5d1f-d889-42e9-94ea-b9b33585fc6b", "action": "mcp.created", "actor_type": "user", "actor_id": "04f37679-bfbf-4906-b749-01756515cecf", "actor_display_name": "string", "resource_type": "mcp", "resource_id": "4d5215ed-38bb-48ed-879a-fdb9ca58522f", "resource_display_name": "string", "resources": { "mcp_id": "92dad337-069f-4a18-a93d-2e7f16082ffb", "mcp_display_name": "string", "agent_instance_id": "e6b55a46-e2a1-4495-b96e-367af02e9908", "agent_instance_display_name": "string", "agent_slug": "string", "autonomous": true, "user_id": "a169451c-8525-4352-b8ca-070dd449a1a5", "user_display_name": "string", "connection_id": "d3547de1-d1f2-4344-b4c2-17169b7526f9", "policy_id": "ee9b03e0-6495-427a-85a5-34444d24ae04", "policy_display_name": "string", "dlp_rule_id": "e090a7ce-e55c-4dad-9728-ac5d9a88f84d", "dlp_rule_display_name": "string", "rate_limit_rule_id": "bf0cd7b5-1b50-4cec-8854-fe1ecbf87d0d", "rate_limit_rule_display_name": "string", "audit_rule_id": "1528ec43-c5cf-46c2-b663-ab8e8b3df829", "audit_rule_display_name": "string", "tag_id": "39c8a0b3-fbe8-4801-95bf-e8a0792edf1d", "tag_display_name": "string", "tool_key": "string", "session_key": "string", "rules": [ { "type": "tool_access", "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "name": "string" } ] }, "context": { "device": "string", "os": "string", "browser": "string", "ip": "string", "city": "string", "country": "string", "user_agent": "string", "trace_id": "string" }, "changes": [ { "type": "create", "path": "string", "from": null, "to": null } ], "payload": { "display_name": "string", "slug": "string", "origin": "catalog" }, "created_at": "2019-08-24T14:15:22Z" } ], "next_cursor": "a7ec8888-a9c3-4732-a281-9a08510f220b"}