Skip to content
Log in
Developer API
Get your keyGet a key

Reference · Creative Board

POST/boards/{boardId}/cards/{cardId}/next-shot

Add the next shot after a clip card, wired from its last frame

The board’s Next shot: a clip card’s last frame becomes a picture card, and a new clip card in the clip’s own settings (model, shape, size, length, sound) opens on it as its start frame, so the action carries straight on across the cut. Give the new clip its words with words. On a clip that is made, the frame is taken now; on one still to be made, the frame waits on the board and is taken, free, the moment the clip is made, and the next clip is made after it (POST /api/v1/boards/{boardId}/run runs them in order). With frame "first" and nextClip false, it puts just the clip’s first frame on the board as a picture. Free: nothing runs and nothing is charged. A repeat with the same Idempotency-Key gets the first answer back instead of more cards.

Key needs
create · Make things and spend credits
Spends
Nothing
Answers
Data
Request
curl -X POST https://vessero.com/api/v1/boards/0b6f3c1e-2d4a-4b5c-8d9e-0f1a2b3c4d5e/cards/9a8b7c6d-5e4f-4a3b-8c2d-1e0f9a8b7c6d/next-shot \
  -H "Authorization: Bearer $VESSERO_API_KEY" \
  -H "Idempotency-Key: 47f8f6f5-ea00-4fb1-925f-76aac956a0ec" \
  -H "Content-Type: application/json" \
  -d '{}'

Path

  • boardIdstringrequired—
  • cardIdstringrequired—

Header

  • Idempotency-KeystringYour id for this request: 8–64 letters, digits, - or _. A repeat within 10 minutes gets the first answer back and never runs twice. Use the same one for the quote and the run.

Body

  • framestringWhich frame of the clip: its last (the default) or its first.lastfirst
  • nextClipbooleanMake the next clip, opening on the frame (the default). False puts just the frame on the board, as a picture card.
  • wordsstringWhat happens in the next clip, as on its card: it opens on the frame, so describe what moves next, not what is already in it.

Answers

  • 200okWhat it did, as data.
  • 400invalid_requestA field is missing or not accepted: see details.
  • 404not_foundNot found on this account.
  • 403feature_unavailableThe studio this needs is switched off for the account right now.
Next in Creative BoardPOST/boards/{boardId}/wires