---
title: POST /audit/feed
description: "Query the audit activity feed — Returns audit events for a resource, newest first, with optional filters."
full: true
---

**Auth:** required. Send an `ivy_` API key (`Authorization: Bearer ivy_…`), a signed-in session token (`Authorization: Bearer …`) or the session cookie (browser sessions). See [Authentication](/docs/api/authentication).

Returns audit events for a resource, newest first, with optional filters. What you see depends on who you are: platform administrators see all events, organization administrators see events for their active organization, and everyone else sees only their own events.

Use `resourceId` of `me` for a personal feed across resource types. This is a read operation sent as POST, so an API key must have write access to call it.

Through the `ivybloom` CLI or its MCP server, this feed always returns your own events, including for administrators.

## Request

### Request body

- `resourceType` (enum (&quot;project&quot; | &quot;campaign&quot; | &quot;chat&quot; | &quot;job&quot; | &quot;export&quot;)) —

- `resourceId` (string) —
Id of the resource, or `me` for a personal feed. Required unless `resourceType` is `project`.

- `limit` (integer) —
Events to return: a whole number of at least 1, or a string of digits. Larger values are capped at 100. Anything else (zero, a negative number, a fraction, other text) returns 400.

- `offset` (integer) —
Events to skip before the first one returned: a whole number of 0 or more, or a string of digits. Anything else returns 400.

- `eventCategories` (enum (&quot;auth&quot; | &quot;data&quot; | &quot;job&quot; | &quot;admin&quot; | &quot;security&quot; | &quot;export&quot; | &quot;compliance&quot; | &quot;system&quot;)[]) —
Match any of these categories. Unrecognised values are ignored.

- `outcomes` (enum (&quot;success&quot; | &quot;failure&quot; | &quot;denied&quot; | &quot;partial&quot; | &quot;pending&quot;)[]) —
Match any of these outcomes. Unrecognised values are ignored.

- `severities` (enum (&quot;debug&quot; | &quot;info&quot; | &quot;warning&quot; | &quot;error&quot; | &quot;critical&quot;)[]) —
Match any of these severities. Unrecognised values are ignored.

- `eventCategory` (any) —
Single-value form of `eventCategories`; an invalid value returns 400.

- `outcome` (any) —
Single-value form of `outcomes`; an invalid value returns 400.

- `severity` (any) —
Single-value form of `severities`; an invalid value returns 400.

## Responses

### `200` OK

Matching audit events

Response shape:

- `data` (object[]) —

### `400` Bad Request

Invalid request

Response shape: `object`

### `401` Unauthorized

Authentication required

Response shape: `object`

### `403` Forbidden

Your identity could not be resolved, or the API key does not allow this access

Response shape: `object`

### `429` Too Many Requests

Rate limit exceeded

Response shape: `object`

### `503` Service Unavailable

The audit log could not be read. Try again later; the feed never answers with an empty list when the read failed

Response shape: `object`

**curl**

```bash
curl -X POST 'https://ivybiosciences.com/api/audit/feed' \
  -H "Authorization: Bearer $IVY_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
  "resourceType": "project"
}'
```

**JavaScript**

```js
const res = await fetch('https://ivybiosciences.com/api/audit/feed', {
  method: 'POST',
  headers: {
    'Authorization': `Bearer ${process.env.IVY_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
  "resourceType": "project"
}),
});
const data = await res.json();
```

**Python**

```python
import os, requests

res = requests.post(
    "https://ivybiosciences.com/api/audit/feed",
    headers={"Authorization": f"Bearer {os.environ['IVY_API_KEY']}"},
    json={
  "resourceType": "project"
},
)
data = res.json()
```
