Skip to content
Get your keyGet a key

Reference · Creative Board

POST/boards/{boardId}/wires

Wire cards together

Wire cards on one of their boards together, each wire checked as the board checks one: it carries what the pair can (a picture into a clip as first-frame, last-frame or reference; a voiceover into a clip as audio), up to what the card takes. A card not made yet can be wired already; running the board makes it first. A wire that cannot be made says why and what the pair can carry. GET /api/v1/boards/guide lists what each card takes in. Free: nothing runs and nothing is charged.

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/wires \
  -H "Authorization: Bearer $VESSERO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "wires": [
      {
        "from": "text",
        "to": "text"
      }
    ]
  }'

Path

  • boardIdstringrequired—

Body

  • wiresobject[] · up to 50requiredThe wires to make.
    • fromstringrequiredThe card the wire leaves.
    • tostringrequiredThe card it feeds.
    • rolestringWhat it carries; left out, the usual one for the pair.referencefirst-framelast-framepromptaudioclipvoice
    • portstringWhere on a clip card it lands, when no role is given: first-frame, last-frame, reference, audio or voice.

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/remove