---
title: "Get audit-log event catalog"
method: GET
path: "/api/audit-logs/event-catalog"
tags: ["Audit Logs"]
---

# Get audit-log event catalog

`GET /api/audit-logs/event-catalog`

## Request

- Base URL: `https://app.cotool.ai`
- URL: `https://app.cotool.ai/api/audit-logs/event-catalog`
- Auth: HTTP bearer

Retrieve the canonical catalog of every audit-log event type the platform can emit, including events that have never been recorded for this organization. Use /api/audit-logs/filter-options to get only the values present in this org's audit logs.

## Response `200`

Successful response

- object: Canonical catalog of all possible audit-log event types, independent of whether they have ever been recorded for the organization.
  - `events` object[], required: Every audit-log event type the platform can emit
    - `event` string, required: Audit-log event type identifier (e.g., user.login, agent.runStarted)
    - `actor` string, required: Actor type that emits this event (user, agent, or chat)
    - `description` string, required: Human-readable description of when this event is recorded

## Other responses

- `400`: Bad request — input validation failed or the request was malformed
- `401`: Unauthorized — missing or invalid API key / session
- `403`: Forbidden — the authenticated user lacks the required permissions
- `500`: Internal server error

---

[API](https://skmtc.dev/cotool/apis/cotool-api.md) - [All operations](https://skmtc.dev/cotool/apis/cotool-api/llms.txt) - [OpenAPI document](https://skmtc.dev/cotool/apis/cotool-api/revisions/f5abe0add203?raw)