Storyboards

Undo or redo one step

One step through the storyboard's single history, whoever made the step. rev asserts the version you read (409 when it moved on); left out, the current one.

post/v1/storyboards/{id}/history

Request

  • Base URL: https://nanostudiopro.com/api
  • URL: https://nanostudiopro.com/api/v1/storyboards/{id}/history
  • Auth: HTTP bearer

Request body

action'undo' | 'redo' required
revinteger

Response

The storyboard after the step

idstring
namestring
project_idstring nullable
urlstring uri

The storyboard's page, where the owner watches.

revinteger
can_undoboolean
can_redoboolean
read_onlyboolean

Saved by a newer version of the app: doc is null and nothing can change.

docobject nullable

idea, cast, places, panels (keyframes), segments, decisions, cues, startPanelId, agentSpend; and when set: theme (the title music), sounds (the film's sound list), ambience (place id -> its sound), endScreens (ending keyframe id -> its end screen), mix (the sound layers' levels set by hand), score (the music on the timeline: cues, each {id, soundId, fromPanelId, toPanelId?, path?, offsetS?, fadeInS?, fadeOutS?, level?, scored?}); each take's effects (sound effects at a second of its clip: {id, soundId, atS, level?, pitch?, rise?}).

acknowledgedstring[]

The issue keys marked as intended (doc.acknowledged).

ai_feedbackobject

What the owner said of each AI continuity finding, by its key: {verdict: intended|wrong|correct, note?, at, version (of the check), text (what it said), takeIds}. Set with the mutation {op: "setAiFeedback", key, verdict, note?} (note up to 300 characters; verdict null clears it). "intended" also marks it as intended; "wrong" hides it and a re-run on the same takes does not raise it again; the note is told to the next check of that clip or cut.

Example response

{
  "issues": [
    {
      "rule": "continuity.outfit",
      "key": "segment:s1:continuity.outfit:mira"
    }
  ],
  "paths": [
    {
      "timeline": [
        {
          "enter": {
            "why": "same place"
          },
          "after_choice": {
            "why": "same place"
          }
        }
      ]
    }
  ]
}

Changes

No recorded changes to this operation across all 3 revisions of this API.