# Audit + agent-event timeline (newest first)

`GET https://api.instacloud.com/projects/{projectId}/events`

**Token scope:** `account` · `org` · `project` — read-only tokens allowed.

## Parameters

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `branch` | query | `string` | no | branch id; also includes project-scoped events |
| `limit` | query | `integer` | no |  |
| `projectId` | path | `string` | yes |  |

## Response 200

Default Response

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `events` | `object[]` | no |  |
| `events.id` | `string` | no |  |
| `events.project_id` | `string` | no |  |
| `events.branch_id` | `string \| null` | no |  |
| `events.source` | `"agent" \| "resource"` | no |  |
| `events.kind` | `string` | no |  |
| `events.payload` | `object` | no |  |
| `events.actor_user_id` | `string \| null` | no | Better Auth user id (opaque string, not a UUID) |
| `events.dedup_key` | `string \| null` | no |  |
| `events.created_at` | `string` | no |  |