Skip to main content
    Ivy Biosciences Docs/Call the platform/API/Reference/Reference/Audit/POST /audit/feed

    POST /audit/feed

    Query the audit activity feed — Returns audit events for a resource, newest first, with optional filters.

    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.

    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

    resourceTypeenum ("project" | "campaign" | "chat" | "job" | "export")
    resourceIdstring

    Id of the resource, or me for a personal feed. Required unless resourceType is project.

    limitinteger

    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.

    offsetinteger

    Events to skip before the first one returned: a whole number of 0 or more, or a string of digits. Anything else returns 400.

    eventCategoriesenum ("auth" | "data" | "job" | "admin" | "security" | "export" | "compliance" | "system")[]

    Match any of these categories. Unrecognised values are ignored.

    outcomesenum ("success" | "failure" | "denied" | "partial" | "pending")[]

    Match any of these outcomes. Unrecognised values are ignored.

    severitiesenum ("debug" | "info" | "warning" | "error" | "critical")[]

    Match any of these severities. Unrecognised values are ignored.

    eventCategoryany

    Single-value form of eventCategories; an invalid value returns 400.

    outcomeany

    Single-value form of outcomes; an invalid value returns 400.

    severityany

    Single-value form of severities; an invalid value returns 400.

    Responses

    200 OK

    Matching audit events

    Response shape:

    dataobject[]

    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 -X POST 'https://ivybiosciences.com/api/audit/feed' \
      -H "Authorization: Bearer $IVY_API_KEY" \
      -H 'Content-Type: application/json' \
      -d '{
      "resourceType": "project"
    }'

    Was this page helpful?

    Loading...