Documentation menu

api

Shots

The shot object, and the endpoint that changes exactly one of them.

Last updated 2026-07-10

The shot object

Each shot in a sequence outcome carries its role in the arc (hook, development, payoff), narrative and emotional purpose, camera spec, routed model, attached continuity reference ids, render result, and provenance record. It is a view of the Canonical Shot Object.

refine_shot

request
{
  "original_intent": "15 second trail shoe launch film",
  "shot_id": "shot_3",
  "change": "golden hour backlight instead of overcast"
}

The change applies to the named shot's canonical object in the channel it affects; continuity references stay locked and other shots are untouched by construction. See channel-scoped refinement.

Errors

StatusMeaning
400Missing original_intent, shot_id, or change
422 (blocked)The change ran into safety policy; nothing spent
Shots | Cadenza Docs