---
title: "Paginated drift alerts for an org fleet"
method: GET
path: "/orgs/{org_id}/drift"
tags: ["Drift"]
---

# Paginated drift alerts for an org fleet

`GET /orgs/{org_id}/drift`

## Request

- Base URL: `https://api.mnemom.ai/v1`
- URL: `https://api.mnemom.ai/v1/orgs/{org_id}/drift`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-Mnemom-Api-Key`
  - API key in cookie `mnemom_session`

Returns active and recent drift alerts for every agent in the org, plus a summary block (total_active, agents_drifting, high_severity, trend). Any org member may read. Feature-gated: `fleet_dashboard`.

## Path parameters

- `org_id` string, required

## Query parameters

- `limit` integer
- `offset` integer

## Response `200`

Drift alerts + summary.

- object
  - `alerts` DriftAlert[]
    - `alert_id` string
    - `agent_id` string
    - `session_id` string
    - `checkpoint_ids` string[]
    - `sustained_checks` integer
    - `severity` 'low' | 'medium' | 'high'
    - `drift_direction` string
    - `message` string
    - `detection_timestamp` string, date-time
  - `summary` object
    - `total_active` integer
    - `agents_drifting` integer
    - `high_severity` integer
    - `trend` 'stable' | 'worsening' | 'improving'

## Other responses

- `400`: Bad request
- `401`: Authentication required
- `402`: Paid feature gate — the caller's plan doesn't include this operation's feature flag. Emitted by `requireFeature` / `requireEntitlement` in `src/org/rbac.ts`.
- `403`: Forbidden
- `404`: Resource not found
- `429`: Rate-limit exceeded. The global per-IP limiter (100 requests/minute, applied to every `/v1/*` route) rejected this request. Back off until the window resets — `Retry-After` carries the cooldown in seconds and `X-RateLimit-Reset` the absolute reset time.
- `500`: Server error — request was well-formed but the server failed to fulfill it. Typically a downstream dependency (DB / RPC / external API) returned an unexpected error.
- `503`: An upstream dependency is currently unavailable. The request was not processed; retry after the cooldown window.

---

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