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

Reference · Your page

PATCH/page/blocks/{blockId}

Change, move, show or hide a block

Change one block on the person’s page: its fields (data, the whole set for its kind, as POST /api/v1/page/blocks lists them), its style, a link’s picture (thumb: a picture of theirs by its useAs, or null to take it off; the rest of its fields stay), turn it off or on (on), or move it (move: top, bottom, up or down). To put a link in a collection, take it out or change their order, send the collection’s data with its new ids. A link’s motion and style: spotlight come with every plan. A poll’s votes stay with each option’s id. An AI app never removes a block: turn it off instead, and the person can remove it in the app. Find ids with GET /api/v1/page. Free.

Key needs
create · Make things and spend credits
Spends
Nothing
Answers
Data
Request
curl -X PATCH https://vessero.com/api/v1/page/blocks/3c2b1a0f-9e8d-4c7b-a6f5-e4d3c2b1a0f9 \
  -H "Authorization: Bearer $VESSERO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'

Path

  • blockIdstringrequired—

Body

  • dataobjectThe block’s fields, all of them for its kind.
  • stylestringFor a link: classic, featured or spotlight (every plan).classicfeaturedspotlight
  • thumbobject · kind library | upload | nullA link’s picture: a picture of theirs by its useAs; null takes it off.
  • onbooleanfalse turns it off (hidden from visitors, kept); true turns it back on.
  • movestringWhere to move it.topbottomupdown

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 Your pagePATCH/page/look