The context endpoint returns structured data for an editor agent: timeline items, transcript segments, media assets, and project settings.

## Endpoint [#endpoint]

* `GET /v1/projects/{project_id}/context`

## Modes [#modes]

`mode` controls how much data is returned:

* `summary`: project summary, counts, preferences
* `assets`: media assets (supports search + pagination)
* `timeline`: minimal timeline items
* `transcript`: transcript segments
* `full`: full context (default)

## Example (Full Context) [#example-full-context]

```bash title="Terminal"
curl "https://blitzreels.com/api/v1/projects/{project_id}/context" \
  -H "Authorization: Bearer $BLITZREELS_API_KEY"
```

## Example (Timeline Only) [#example-timeline-only]

```bash title="Terminal"
curl "https://blitzreels.com/api/v1/projects/{project_id}/context?mode=timeline" \
  -H "Authorization: Bearer $BLITZREELS_API_KEY"
```

## Tips [#tips]

* Use `mode=assets` with `search`, `asset_limit`, and `asset_offset` for paging large libraries.
* Pair with Timeline APIs for precision edits.

## Related [#related]

* [Timeline Editing API](/docs/timeline)
* [Overlays API](/docs/overlays)
* [Captions API](/docs/captions)