POST
Create Run
Create a new run stub for a story.
No response yet
Diagnostics
API Test Tools
Exercise the application APIs with default payloads. Adjust the request details, send calls against internal services or public endpoints, and inspect the live responses.
Environment Targets
Define the base origins for the internal microservices cluster and the external partner API. Paths can also be overridden per request.
ffmpeg workflow
Upload Assets & Run Video Job
Convert local test assets to data URLs, submit them to the ffmpeg API, poll for results, and fetch the archived render log without leaving the admin test page.
Upload a source video, optionally add logo/audio assets, then run a render.
Job result
Create or check a job to see status JSON.
ffmpeg log
Log output appears after the API archives or exposes it.
Internal APIs
Endpoints that power the operator console, guardrails, and story management.
POST
Advance Run Beat
Generate the next beat for an existing run.
Replace the run ID with a valid UUID. The optional index query overrides the next beat pointer.
Body not required for this request.
No response yet
GET
Fetch Run Replay
Fetch and sign a replay payload for a completed run.
Replace the run ID with a valid identifier.
Body not required for this request.
No response yet
GET
List Stories
List narrative stories stored in Supabase.
Body not required for this request.
No response yet
POST
Generate Scene Imagery
Request concept art for a scene path via the OpenAI image service.
Requires OPENAI_API_KEY configured on the API service.
No response yet
POST
Create Room
Provision a co-play room linked to a story or run.
No response yet
GET
Inspect Supabase Session
Validate the Supabase session using the sb-access-token cookie/header.
Include an sb-access-token header or cookie when testing real sessions. Without a token, the response returns nulls.
Body not required for this request.
No response yet
External APIs
Endpoints exercised by guests, partners, or automation outside the console.
POST
Start Demo
Begin the 3-beat Haunted Shore demo flow.
No body required. Returns guest and run identifiers for follow-up calls.
Body not required for this request.
No response yet
POST
Advance Demo
Advance to the next beat in the guest demo session.
Use the guest_id returned from the demo start response.
No response yet
POST
Complete Demo
Clear demo state and surface CTA destinations.
No response yet
POST
Create Video Job
Submit a branded video render using overlay instructions.
Requires a valid VIDEO_API_KEY configured on the API origin.
No response yet
GET
Check Video Job Status
Poll the processing status for a video render job.
Replace job_12345 with the identifier returned from the create job request.
Body not required for this request.
No response yet
GET
Download Video Output
Retrieve the rendered asset once the job completes.
Successful jobs redirect to the generated asset URL.
Body not required for this request.
No response yet
GET
Fetch Video Job Log
Fetch the archived ffmpeg log for a video render job.
Replace job_12345 with the identifier returned from the create job request.
Body not required for this request.
No response yet