Put a Library piece, an upload or a product on a board

Put one of their own things on a board as a card: a file they uploaded or a piece from their library (GET /api/v1/library, its uploads and made tabs), a product (GET /api/v1/products), a brand kit (GET /api/v1/boards/guide lists theirs) or a cast member, one of theirs or of the starter cast every account has (GET /api/v1/cast). It lands beside the board’s cards, or at x, y, ready to wire into the cards that use it. Free: nothing runs and nothing is charged. A repeat with the same Idempotency-Key gets the first answer back instead of a second card.

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/place \
  -H "Authorization: Bearer $VESSERO_API_KEY" \
  -H "Idempotency-Key: 47f8f6f5-ea00-4fb1-925f-76aac956a0ec" \
  -H "Content-Type: application/json" \
  -d '{
    "what": {
      "upload": "text"
    }
  }'

Path

boardIdstringrequired—

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

whatobjectrequiredWhat to put on it, one of: {upload: id}, {library: {source, id}}, {product: id}, {brand: id}, {cast: {id, pose?, shotId?}}.
xnumberWhere on the board, across, in board units.
ynumberWhere on the board, down, in board units.

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.