# Platform Audit

Platform-level audit search (distinct from the per-tenant audit log above).

Generated from `apps/api/openapi.json`. HTML version: https://docs.institflow.com/en/reference/platform-audit

1 operation.

## GET /api/v1/platform/audit

List audit log entries across every tenant (platform admin only).

- Operation id: `PlatformAuditController_list_v1`
- Permission: —
- Auth: credential required
- `Idempotency-Key`: not required

### Parameters

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `cursor` | query | string | no |  |
| `limit` | query | integer | no | 1–100 · default: 25 |
| `action` | query | string | no | ≥1 chars |
| `entityType` | query | string | no | ≥1 chars |
| `entityId` | query | string (uuid) | no |  |
| `actorUserId` | query | string (uuid) | no |  |
| `from` | query | string (date-time) | no |  |
| `to` | query | string (date-time) | no |  |
| `tenantId` | query | string (uuid) | no |  |

### Responses

**200** — A page of audit log entries.

| Property | Type | Required | Constraints |
| --- | --- | --- | --- |
| `data` | array<object> | yes |  |
| `nextCursor` | string \| null | yes |  |

Every other status answers with the shared `ErrorEnvelope` — see
https://docs.institflow.com/md/en/error-codes.md

### Example request

```bash
curl -X GET "https://your-institute.example/api/v1/platform/audit" \
  -H "Authorization: Bearer $INSTITFLOW_API_KEY"
```