# List audit events

**GET /api/v1/organizations/{id}/audit-events**

Returns the organization activity feed (actions taken across the org's projects), newest first. Keyset/cursor paginated.


## Servers
- https://agentengine.mongodb.com: https://agentengine.mongodb.com ()


## Authentication methods
- Bearer auth


## Parameters

### Path parameters

- **id** (string)
  Organization whose audit feed to read


### Query parameters

- **project_id** (string)
  Filter by project

- **limit** (integer)
  Max events per page (default 50, max 200)

- **cursor** (string)
  Opaque keyset cursor for the next page

- **action** (string)
  Filter by action (e.g. agent.deploy)

- **category** (string)
  Filter by category: access or mutation

- **actor_email** (string)
  Filter by actor email

- **outcome** (string)
  Filter by outcome: success or failure

- **start_time** (string)
  Start of time range (RFC3339)

- **end_time** (string)
  End of time range (RFC3339)

- **show_admin_events** (boolean)
  Include admin events (operator actions and GSA runtime events); default false hides them



## Responses
### 406
Unsupported or malformed API version, an operation unavailable in the selected published contract, or an unacceptable representation (including unsupported media-type parameters or excluded SSE). Existing authentication, authorization, and rate-limit failures take precedence.

#### Body: application/json (object)
- **badRequestDetail** (object)
  Optional validation details defined by the standard error schema; API negotiation errors do not emit this field.

- **detail** (string)
  Human-readable error details.

- **error** (integer)
  HTTP status code.

- **errorCode** (string)
  Machine-readable error code.

- **parameters** (array[string])
  Request parameter names associated with the error; omitted when none apply.

- **reason** (string)
  HTTP status reason phrase.


### 200
OK

#### Body: application/json (object)
- **audit_events** (array[object])

- **has_more** (boolean)

- **next_cursor** (string)


### 400
Bad Request

#### Body: application/json (object)
- **code** (string)

- **error** (string)

- **success** (boolean)


### 401
Unauthorized

#### Body: application/json (object)
- **code** (string)

- **error** (string)

- **success** (boolean)


### 403
Forbidden

#### Body: application/json (object)
- **code** (string)

- **error** (string)

- **success** (boolean)


### 500
Internal Server Error

#### Body: application/json (object)
- **code** (string)

- **error** (string)

- **success** (boolean)



[Powered by Bump.sh](https://bump.sh)