Studio API

Plug Film Forge capabilities into your own systems. The API exposes each production's ProjectVessel and finance data, and lets you push revenue events that flow through the recoupment waterfall — all keyed to a per-production API key.

Authentication

Create a key in the workspace under Settings → Studio API. Send it on every request:

curl https://filmforge.app/api/v1/productions/PROD_ID/vessel \
  -H "X-API-Key: ff_live_…"

Endpoints

GET/v1/productions/{id}/vesselread

The full ProjectVessel — the production's digital twin across every domain (creative, production, finance, post, distribution, trust).

GET/v1/productions/{id}/financeread

The finance domain: budget, incentives, §181, cap table, recoupment waterfall, tokenization, and risk profile.

POST/v1/productions/{id}/revenuewrite

Log a distribution revenue event. Feeds the recoupment waterfall and triggers orchestration (webhooks + risk refresh).

Webhooks

Register endpoints in the workspace to receive events. Each delivery includesX-FilmForge-Event and anX-FilmForge-Signature header (sha256=HMAC(secret, body)). Emitted events:

budget.lockedrevenue.receivedsection181.electedcap.notarized

Film Forge · Studio API v1