Lazer Docs
API Reference

Extension API Endpoints

Complete reference for extension REST endpoints

Extension API Endpoints

This document provides detailed reference for all Chrome extension API endpoints, including request/response formats and examples.

Base URL

All endpoints are relative to your Lazer instance:

https://lazer.yourdomain.com/api/extension

Authentication

All endpoints require Bearer token authentication:

Authorization: Bearer lzr_your_token_here

See Authentication for details.

GET /api/extension/projects

List all projects for the authenticated user.

Request

GET /api/extension/projects HTTP/1.1
Host: lazer.yourdomain.com
Authorization: Bearer lzr_abc123...

Response

{
  "projects": [
    {
      "id": "proj_abc123",
      "name": "Feature Film - The Awakening",
      "status": "DEVELOPMENT",
      "genre": "Sci-Fi",
      "updatedAt": "2026-02-14T10:30:00Z",
      "sceneCount": 42
    },
    {
      "id": "proj_def456",
      "name": "Commercial - Tech Product",
      "status": "PRODUCTION",
      "genre": "Commercial",
      "updatedAt": "2026-02-13T15:20:00Z",
      "sceneCount": 8
    }
  ]
}

Fields

  • id (string) - Unique project identifier
  • name (string) - Project name
  • status (string) - Project status: DEVELOPMENT, PRE_PRODUCTION, PRODUCTION, POST_PRODUCTION, COMPLETED, ARCHIVED
  • genre (string) - Project genre (nullable)
  • updatedAt (string) - ISO 8601 timestamp of last update
  • sceneCount (number) - Total number of scenes in project

Status Codes

  • 200 - Success
  • 401 - Unauthorized (invalid or expired token)

GET /api/extension/scenes

List all scenes for a specific project.

Request

GET /api/extension/scenes?projectId=proj_abc123 HTTP/1.1
Host: lazer.yourdomain.com
Authorization: Bearer lzr_abc123...

Query Parameters

  • projectId (string, required) - Project ID to fetch scenes for

Response

{
  "scenes": [
    {
      "id": "scene_001",
      "sceneId": "001",
      "storyBeat": "INT. SPACESHIP BRIDGE - DAY\n\nCommander watches the stars...",
      "act": 1,
      "macroScene": "Opening sequence"
    },
    {
      "id": "scene_002",
      "sceneId": "002",
      "storyBeat": "EXT. ALIEN PLANET - CONTINUOUS\n\nThe crew explores...",
      "act": 1,
      "macroScene": "Discovery"
    }
  ]
}

Fields

  • id (string) - Unique scene database identifier
  • sceneId (string) - Scene number (e.g., "001", "002A")
  • storyBeat (string) - Scene description/action (nullable)
  • act (number) - Act number (nullable)
  • macroScene (string) - Macro scene/sequence name (nullable)

Status Codes

  • 200 - Success
  • 400 - Bad Request (missing projectId)
  • 401 - Unauthorized
  • 404 - Project not found or not owned by user

GET /api/extension/scene-assets

List asset versions for a specific scene.

Request

GET /api/extension/scene-assets?projectId=proj_abc123&sceneId=001&assetType=VIDEO&limit=30 HTTP/1.1
Host: lazer.yourdomain.com
Authorization: Bearer lzr_abc123...

Query Parameters

  • projectId (string, required) - Project ID
  • sceneId (string, required) - Scene ID (e.g., "001")
  • assetType (string, optional) - Filter by asset type: IMAGE, VIDEO, AUDIO, MUSIC, VOICE, NARRATION, STORYBOARD, OTHER
  • limit (number, optional) - Max results (default: 30, max: 100)

Response

{
  "scene": {
    "id": "scene_001",
    "sceneId": "001",
    "storyBeat": "INT. SPACESHIP BRIDGE - DAY..."
  },
  "assets": [
    {
      "id": "asset_xyz789",
      "assetType": "VIDEO",
      "platformKey": "openai-sora",
      "prompt": "A futuristic spaceship bridge with holographic displays",
      "outputUrl": "https://cdn.sora.com/video123.mp4",
      "thumbnailUrl": "https://cdn.sora.com/thumb123.jpg",
      "status": "GENERATED",
      "versionNumber": 3,
      "createdAt": "2026-02-14T12:00:00.000Z"
    }
  ]
}

Fields

Scene Object

  • id (string) - Scene database ID
  • sceneId (string) - Scene number
  • storyBeat (string) - Scene description

Asset Object

  • id (string) - Asset version ID
  • assetType (string) - Asset type
  • platformKey (string) - Platform slug
  • prompt (string) - Generation prompt
  • outputUrl (string) - Media file URL
  • thumbnailUrl (string) - Thumbnail URL (nullable)
  • status (string) - DRAFT, GENERATED, SELECTED, APPROVED, FINAL
  • versionNumber (number) - Version number within scene/type/platform
  • createdAt (string) - ISO 8601 timestamp

Status Codes

  • 200 - Success
  • 400 - Bad Request (missing required params)
  • 401 - Unauthorized
  • 404 - Project or scene not found

GET /api/extension/platforms

List all available AI platforms.

Request

GET /api/extension/platforms HTTP/1.1
Host: lazer.yourdomain.com
Authorization: Bearer lzr_abc123...

Response

{
  "platforms": [
    {
      "id": "platform_001",
      "slug": "openai-sora",
      "name": "OpenAI Sora",
      "provider": "OpenAI",
      "specialties": ["video", "image"],
      "supportedOutput": ["VIDEO", "IMAGE"],
      "homepageUrl": "https://sora.com",
      "docsUrl": "https://platform.openai.com/docs/sora"
    },
    {
      "id": "platform_002",
      "slug": "google-veo",
      "name": "Google Gemini / Veo",
      "provider": "Google",
      "specialties": ["video", "image", "multi"],
      "supportedOutput": ["VIDEO", "IMAGE"],
      "homepageUrl": "https://gemini.google.com",
      "docsUrl": "https://ai.google.dev/veo"
    }
  ]
}

Fields

  • id (string) - Platform database ID
  • slug (string) - Unique platform key (used in ingest)
  • name (string) - Display name
  • provider (string) - Company/organization
  • specialties (array) - Tags like "video", "image", "audio", "music"
  • supportedOutput (array) - Asset types: VIDEO, IMAGE, AUDIO, etc.
  • homepageUrl (string) - Platform homepage (nullable)
  • docsUrl (string) - Platform documentation (nullable)

Status Codes

  • 200 - Success
  • 401 - Unauthorized

POST /api/extension/ingest

Create a new asset version from captured data.

Request

POST /api/extension/ingest HTTP/1.1
Host: lazer.yourdomain.com
Authorization: Bearer lzr_abc123...
Content-Type: application/json

{
  "projectId": "proj_abc123",
  "sceneId": "001",
  "platformKey": "openai-sora",
  "assetType": "VIDEO",
  "prompt": "A futuristic spaceship bridge with holographic displays",
  "outputUrl": "https://cdn.sora.com/video123.mp4",
  "thumbnailUrl": "https://cdn.sora.com/thumb123.jpg",
  "title": "Take 2 - Brighter lighting",
  "sourceUrl": "https://sora.com/generate/abc123",
  "modelName": "Sora Turbo",
  "negativePrompt": "dark, gloomy",
  "metadata": {
    "duration": 5,
    "aspectRatio": "16:9",
    "seed": 42
  },
  "tags": ["hero", "approved"],
  "status": "GENERATED",
  "notes": "Client prefers this version",
  "shotId": "shot_xyz789"
}

Request Body

Required Fields

  • projectId (string) - Project ID (must belong to authenticated user)
  • sceneId (string) - Scene ID (e.g., "001")
  • platformKey (string) - Platform slug (e.g., "openai-sora")
  • assetType (string) - Asset type: IMAGE, VIDEO, AUDIO, MUSIC, VOICE, NARRATION, STORYBOARD, OTHER
  • prompt (string) - Generation prompt (min 1 character)
  • outputUrl (string, optional) - Media file URL (must be valid HTTP/HTTPS URL)

Optional Fields

  • platformId (string) - Platform database ID (alternative to platformKey)
  • title (string) - Descriptive title
  • sourceUrl (string) - Platform page URL where generated
  • thumbnailUrl (string) - Thumbnail/preview URL
  • modelName (string) - AI model name/version
  • negativePrompt (string) - Things to avoid in generation
  • metadata (object) - Structured JSON metadata (duration, aspectRatio, seed, etc.)
  • tags (array) - Array of string tags
  • status (string) - DRAFT, GENERATED, SELECTED (default: DRAFT)
  • notes (string) - Free-form notes
  • shotId (string) - Shot ID if capturing to specific shot
  • selected (boolean) - Mark as selected (overrides status)
  • externalAssetId (string) - Platform's job/generation ID
  • promptPackageId (string) - Prompt package this was generated from (advanced)
  • compareGroup (string) - Compare group identifier (advanced)
  • rightsState (string) - Rights state: UNKNOWN, NON_COMMERCIAL, COMMERCIAL_ALLOWED, RESTRICTED (default: UNKNOWN)
  • createPromptPackage (boolean) - Auto-create a prompt package from the capture
  • promptPackage (object) - Custom prompt package data (name, prompt, negativePrompt, constraints, targetAspectRatio, targetDurationSec, styleProfile, tags, metadata)
  • provenance (object) - JSON provenance metadata (capture source, extension version)
  • platformLabel (string) - Platform display name
  • parentVersionId (string) - Parent version for iteration chains
  • costEstimateUsd (number) - Estimated cost in USD
  • generationSeconds (number) - Generation time
  • queueWaitSeconds (number) - Queue wait time

Response

{
  "ok": true,
  "asset": {
    "id": "asset_xyz789",
    "versionNumber": 3,
    "platformKey": "openai-sora",
    "platformLabel": "OpenAI Sora",
    "assetType": "VIDEO",
    "status": "GENERATED",
    "rightsState": "UNKNOWN",
    "shotId": "shot_xyz789",
    "createdAt": "2026-02-14T12:00:00.000Z"
  }
}

Status Codes

  • 200 - Success (asset created)
  • 400 - Bad Request (validation error)
  • 401 - Unauthorized
  • 404 - Project, scene, or shot not found
  • 500 - Internal server error

Validation Rules

  • prompt must be at least 1 character
  • outputUrl must be a valid HTTP/HTTPS URL (if provided)
  • sceneId is case-insensitive and auto-uppercased
  • platformKey is case-insensitive and auto-lowercased
  • assetType must match enum values exactly
  • metadata must be valid JSON

GET /api/extension/profile

Get user profile and extension preferences.

Request

GET /api/extension/profile HTTP/1.1
Host: lazer.yourdomain.com
Authorization: Bearer lzr_abc123...

Response

{
  "preferences": {
    "lastActiveProjectId": "proj_abc123",
    "lastActiveSceneId": "scene_001",
    "defaultAssetType": "VIDEO",
    "defaultStatus": "GENERATED",
    "enabledPlatforms": ["openai-sora", "google-veo", "freepik-ai"],
    "autoFillEnabled": true
  }
}

Fields

  • lastActiveProjectId (string) - Last selected project
  • lastActiveSceneId (string) - Last selected scene
  • defaultAssetType (string) - Default asset type
  • defaultStatus (string) - Default status
  • enabledPlatforms (array) - Enabled platform keys
  • autoFillEnabled (boolean) - Auto-fill on detection

Status Codes

  • 200 - Success
  • 401 - Unauthorized

PUT /api/extension/profile

Update user preferences.

Request

PUT /api/extension/profile HTTP/1.1
Host: lazer.yourdomain.com
Authorization: Bearer lzr_abc123...
Content-Type: application/json

{
  "preferences": {
    "lastActiveProjectId": "proj_abc123",
    "lastActiveSceneId": "scene_002",
    "defaultAssetType": "IMAGE"
  }
}

Request Body

  • preferences (object) - Partial preferences update (any fields from GET response)

Response

Same as GET /api/extension/profile (returns updated preferences).

Status Codes

  • 200 - Success
  • 400 - Bad Request (invalid preferences)
  • 401 - Unauthorized
  • 404 - User not found

GET /api/extension/shots

List shots for a specific scene.

Request

GET /api/extension/shots?sceneDbId=scene_001 HTTP/1.1
Host: lazer.yourdomain.com
Authorization: Bearer lzr_abc123...

Query Parameters

  • sceneDbId (string, required) - Scene database ID

Response

{
  "shots": [
    {
      "id": "shot_xyz789",
      "shotCode": "001A",
      "description": "Wide shot of spaceship bridge",
      "sortOrder": 1
    },
    {
      "id": "shot_abc123",
      "shotCode": "001B",
      "description": "Close-up of commander",
      "sortOrder": 2
    }
  ]
}

Fields

  • id (string) - Shot database ID
  • shotCode (string) - Shot code/number
  • description (string) - Shot description (nullable)
  • sortOrder (number) - Sort order within scene

Status Codes

  • 200 - Success
  • 400 - Bad Request (missing sceneDbId)
  • 401 - Unauthorized
  • 404 - Scene not found

GET /api/extension/characters

List characters for a specific project.

Request

GET /api/extension/characters?projectId=proj_abc123 HTTP/1.1
Host: lazer.yourdomain.com
Authorization: Bearer lzr_abc123...

Query Parameters

  • projectId (string, required) - Project ID

Response

{
  "characters": [
    {
      "id": "char_001",
      "name": "Commander Sarah Chen",
      "role": "Protagonist",
      "description": "Starship commander with cybernetic enhancements"
    },
    {
      "id": "char_002",
      "name": "Lieutenant Marcus Reed",
      "role": "Supporting",
      "description": "First officer and tactical expert"
    }
  ]
}

Status Codes

  • 200 - Success
  • 400 - Bad Request (missing projectId)
  • 401 - Unauthorized
  • 404 - Project not found

PATCH /api/extension/asset-update

Update asset selection or compare group.

Request

PATCH /api/extension/asset-update HTTP/1.1
Host: lazer.yourdomain.com
Authorization: Bearer lzr_abc123...
Content-Type: application/json

{
  "assetId": "asset_xyz789",
  "selected": true,
  "compareGroup": "batch-2026-02-14"
}

Request Body

  • assetId (string, required) - Asset version ID
  • selected (boolean, optional) - Mark as selected/unselected
  • compareGroup (string, optional) - Compare group identifier

Status Codes

  • 200 - Success
  • 400 - Bad Request (validation error)
  • 401 - Unauthorized
  • 404 - Asset not found

Error Handling

All endpoints return errors in a consistent format:

{
  "error": "Error message",
  "details": { ... }
}

Common Errors

401 Unauthorized

{
  "error": "Unauthorized"
}

400 Bad Request (validation)

{
  "error": "Invalid payload",
  "details": {
    "fieldErrors": {
      "prompt": ["Required"],
      "outputUrl": ["Invalid URL"]
    }
  }
}

404 Not Found

{
  "error": "Scene not found"
}

Next Steps

Authentication

Token-based auth for Chrome extension API access

Webhooks & Events

Event-driven integrations (future feature)

On this page

Extension API EndpointsBase URLAuthenticationGET /api/extension/projectsRequestResponseFieldsStatus CodesGET /api/extension/scenesRequestQuery ParametersResponseFieldsStatus CodesGET /api/extension/scene-assetsRequestQuery ParametersResponseFieldsScene ObjectAsset ObjectStatus CodesGET /api/extension/platformsRequestResponseFieldsStatus CodesPOST /api/extension/ingestRequestRequest BodyRequired FieldsOptional FieldsResponseStatus CodesValidation RulesGET /api/extension/profileRequestResponseFieldsStatus CodesPUT /api/extension/profileRequestRequest BodyResponseStatus CodesGET /api/extension/shotsRequestQuery ParametersResponseFieldsStatus CodesGET /api/extension/charactersRequestQuery ParametersResponseStatus CodesPATCH /api/extension/asset-updateRequestRequest BodyStatus CodesError HandlingCommon ErrorsNext Steps