---
title: "GET /orgs/{orgId}/security/events"
method: GET
path: "/orgs/{orgId}/security/events"
---

# GET /orgs/{orgId}/security/events

`GET /orgs/{orgId}/security/events`

## Request

- Base URL: `https://api.useanima.sh/v1`
- URL: `https://api.useanima.sh/v1/orgs/{orgId}/security/events`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-API-Key`

## Path parameters

- `orgId` string, required: Organization identifier (from the URL path)

## Query parameters

- `agentId` string: Filter events by a specific agent
- `type` 'PII_DETECTED' | 'INJECTION_DETECTED' | 'RATE_LIMITED' | 'BLOCKED' | 'APPROVED' | 'REJECTED': Filter events by security event type
- `severity` 'LOW' | 'MEDIUM' | 'HIGH' | 'CRITICAL': Filter events by severity level
- `cursor` string: Pagination cursor for fetching the next page
- `limit` integer: Maximum number of events to return per page

## Response `200`

OK

- object: Paginated list of security events
  - `items` object[], required: List of security events matching the query
    - `id` string, required: Unique security event identifier
    - `orgId` string, required: Organization the event belongs to
    - `agentId` string, nullable, required: Agent that triggered the event, if applicable
    - `messageId` string, nullable, required: Associated message identifier, if applicable
    - `type` string, required: Security event type classification
    - `severity` string, required: Event severity level
    - `details` object, required: Structured metadata and context for the event
    - `resolved` boolean, required: Whether the event has been resolved
    - `resolvedBy` string, nullable, required: Identifier of the user who resolved the event
    - `resolvedAt` string, date-time, nullable, required: Timestamp when the event was resolved
    - `createdAt` string, date-time, required: Timestamp when the event was created
  - `pagination` object, required: Pagination metadata
    - `nextCursor` string, nullable, required: Cursor for retrieving the next page of results
    - `hasMore` boolean, required: Whether additional results are available

---

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