# Intelligence API

Base: `/workspaces/{workspaceId}/buckets/{bucketId}/intelligence`

Dogfood allowlist required. Product guide: [File intelligence](/docs/intelligence).

## Get config + progress

`GET .../intelligence` · `intelligence:read`

```json
{
  "config": { "enabled": true, "features": { "...": true }, "backfillStatus": "running" },
  "progress": { "pending": 12, "completed": 400, "failed": 1 }
}
```

## Patch config

`PATCH .../intelligence` · `intelligence:write`

Merge fields into the bucket intelligence config. Optional `reestimate: true` refreshes the cost estimate.

## Backfill

`POST .../intelligence/backfill` · `intelligence:write`

```json
{ "action": "start", "estimateToken": "..." }
```

Actions: `start` (requires valid `estimateToken` from estimate), `pause`, resume via `start` again after pause.

MCP mirrors this with `get_intelligence` and `start_backfill`.