---
title: "Get project context"
method: GET
path: "/projects/{projectId}/context"
tags: ["Project Context"]
---

# Get project context

`GET /projects/{projectId}/context`

## Request

- Base URL: `https://blitzreels.com/api/v1`
- URL: `https://blitzreels.com/api/v1/projects/{projectId}/context`
- Auth: API key in header `Authorization`

Get project context.

## Path parameters

- `projectId` string, required

## Query parameters

- `mode` 'summary' | 'assets' | 'timeline' | 'transcript' | 'full'
- `search` string
- `asset_limit` number
- `asset_offset` number
- `timeline_limit` number
- `timeline_offset` number
- `transcript_limit` number
- `transcript_offset` number
- `caption_word_limit` number
- `caption_word_offset` number
- `media_asset_types` string[]
- `folder_ids` string[]
- `include_subfolders` boolean
- `include_transcripts` boolean
- `include_caption_words` boolean
- `include_timeline_items` boolean
- `include_media_assets` boolean

## Response `200`

Successful response

- union
  - object
    - `mode` 'summary', required
    - `data` object, required
      - `project` object, required
        - `id` string, required
        - `title` string, required
        - `description` string, nullable, required
        - `aspectRatio` '9:16' | '16:9' | '1:1' | '4:5', required
        - `fps` number, required
        - `unitsPerFrame` number, required
        - `compositionWidth` number, required
        - `compositionHeight` number, required
        - `durationSeconds` number, required
      - `assetCounts` object, required
        - `video` number, required
        - `audio` number, required
        - `image` number, required
      - `timelineItemCounts` object, required
        - `video` number, required
        - `audio` number, required
        - `caption` number, required
        - `image` number, required
        - `fillLayer` number, required
        - `effect` number, required
        - `other` number, required
      - `templateSettings` object, required
        - `isTemplate` boolean, required
        - `variableCount` number, required
        - `bindingCount` number, required
      - `captionStyle` object, required
        - `source` 'organization_default' | 'user_default' | 'built_in_default', required
        - `captionThemeId` string, nullable, required
        - `captionThemeName` string, nullable, required
        - `wordOverrideCount` number, required
      - `userPreferences` object, nullable, required
        - `creatorIdentity` 'educator' | 'storyteller' | 'entertainer' | 'expert' | 'brand' | 'explorer', nullable, required
        - `contentVibe` 'calm' | 'conversational' | 'high-energy' | 'professional', nullable, required
        - `aiWritingStyle` 'conversational' | 'storyteller' | 'educator' | 'hype' | 'documentary', nullable, required
        - `aiControversy` 'safe' | 'mild' | 'edgy', nullable, required
        - `workspaceDescription` string, nullable, required
        - `safeWords` string[], required
    - `bounds` object, required
      - `collections` object[], required
        - `name` string, required
        - `offset` number, required
        - `limit` number, required
        - `total` number, required
        - `returned` number, required
        - `hasMore` boolean, required
        - `truncated` boolean, required
  - object
    - `mode` 'assets', required
    - `data` object, required
      - `assets` object[], required
        - `assetId` string, required
        - `assetType` 'image' | 'video' | 'audio', required
        - `name` string, required
        - `description` string, nullable, required
        - `folderId` string, nullable, required
        - `folderName` string, nullable, required
        - `folderPath` string, nullable, required
        - `tags` string[], required
        - `aiPrompt` string, nullable, required
      - `total` number, required
      - `hasMore` boolean, required
      - `offset` number, required
      - `limit` number, required
    - `bounds` object, required
      - `collections` object[], required
        - `name` string, required
        - `offset` number, required
        - `limit` number, required
        - `total` number, required
        - `returned` number, required
        - `hasMore` boolean, required
        - `truncated` boolean, required
  - object
    - `mode` 'timeline', required
    - `data` object, required
      - `items` object[], required
        - `id` string, required
        - `timelineItemId` string, required
        - `type` string, required
        - `label` string, required
        - `text` string, nullable
        - `mediaAssetId` string, nullable, required
        - `contentItemId` string, nullable, required
        - `captionId` string, nullable, required
        - `startSeconds` number, required
        - `endSeconds` number, required
        - `layerIndex` number, required
        - `volume` number, nullable, required
      - `totalItems` number, required
      - `durationSeconds` number, required
    - `bounds` object, required
      - `collections` object[], required
        - `name` string, required
        - `offset` number, required
        - `limit` number, required
        - `total` number, required
        - `returned` number, required
        - `hasMore` boolean, required
        - `truncated` boolean, required
  - object
    - `mode` 'transcript', required
    - `data` object, required
      - `segments` object[], required
        - `text` string, required
        - `startSeconds` number, required
        - `endSeconds` number, required
      - `totalWords` number, required
      - `durationSeconds` number, required
    - `bounds` object, required
      - `collections` object[], required
        - `name` string, required
        - `offset` number, required
        - `limit` number, required
        - `total` number, required
        - `returned` number, required
        - `hasMore` boolean, required
        - `truncated` boolean, required
  - object
    - `mode` 'full', required
    - `data` object, required
      - `captionWords` object[], required
        - `captionId` string, required
        - `wordId` string, required
        - `word` string, required
        - `sequenceIndex` number, required
        - `orderIndex` number, required
        - `startSeconds` number, required
        - `endSeconds` number, required
      - `captionWordsTable` string, required
      - `transcriptSegments` object, nullable, required
        - `segments` object[], required
          - `text` string, required
          - `startSeconds` number, required
          - `endSeconds` number, required
        - `totalWords` number, required
        - `durationSeconds` number, required
      - `timelineRanges` object[], required
        - `id` string, required
        - `type` string, required
        - `startSeconds` number, required
        - `endSeconds` number, required
        - `label` string, required
      - `timelineItems` object[], required
        - `timelineItemId` string, required
        - `type` string, required
        - `label` string, required
        - `startSeconds` number, required
        - `endSeconds` number, required
        - `layerIndex` number, required
        - `volume` number, nullable, required
        - `mediaAssetId` string, nullable, required
        - `contentItemId` string, nullable, required
        - `captionId` string, nullable, required
        - `positionMode` 'pixels' | 'normalized' | 'preset' | 'none', required
        - `positionX` number, nullable, required
        - `positionY` number, nullable, required
        - `widthPx` number, nullable, required
        - `heightPx` number, nullable, required
        - `keepAspectRatio` boolean, nullable, required
        - `sourceWidth` number, nullable, required
        - `sourceHeight` number, nullable, required
      - `projectSettings` object, required
        - `aspectRatio` '9:16' | '16:9' | '1:1' | '4:5', required
        - `fps` number, required
        - `unitsPerFrame` number, required
        - `compositionWidth` number, required
        - `compositionHeight` number, required
      - `templateSettings` object, required
        - `isTemplate` boolean, required
        - `templateType` 'intro' | 'outro' | 'full' | 'overlay', nullable, required
        - `templateVisibility` 'private' | 'shared' | 'public', required
        - `variables` object[], required
          - `key` string, required
          - `name` string, required
          - `type` 'text' | 'image' | 'color', required
          - `defaultValue` string, nullable, required
        - `bindings` object[], required
          - `variableKey` string, required
          - `timelineItemId` string, required
          - `property` string, required
      - `mediaAssets` object[], required
        - `assetId` string, required
        - `assetType` 'image' | 'video' | 'audio', required
        - `name` string, required
        - `description` string, nullable, required
        - `folderId` string, nullable, required
        - `folderName` string, nullable, required
        - `folderPath` string, nullable, required
        - `tags` string[], required
        - `aiPrompt` string, nullable, required
      - `brollAssets` object[], required
        - `assetId` string, required
        - `assetType` 'image' | 'video' | 'audio', required
        - `name` string, required
        - `description` string, nullable, required
        - `folderId` string, nullable, required
        - `folderName` string, nullable, required
        - `folderPath` string, nullable, required
        - `tags` string[], required
        - `aiPrompt` string, nullable, required
      - `userPreferences` object, nullable, required
        - `creatorIdentity` 'educator' | 'storyteller' | 'entertainer' | 'expert' | 'brand' | 'explorer', nullable, required
        - `contentVibe` 'calm' | 'conversational' | 'high-energy' | 'professional', nullable, required
        - `aiWritingStyle` 'conversational' | 'storyteller' | 'educator' | 'hype' | 'documentary', nullable, required
        - `aiControversy` 'safe' | 'mild' | 'edgy', nullable, required
        - `workspaceDescription` string, nullable, required
        - `safeWords` string[], required
    - `bounds` object, required
      - `collections` object[], required
        - `name` string, required
        - `offset` number, required
        - `limit` number, required
        - `total` number, required
        - `returned` number, required
        - `hasMore` boolean, required
        - `truncated` boolean, required

## Other responses

- `400`: Invalid input data
- `401`: Authorization not provided
- `403`: Insufficient access
- `404`: Not found
- `500`: Internal server error

---

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