Skip to content
Get your keyGet a key

Reference · Your page

PATCH/page/look

The page’s theme, layout, socials and top

Set the person’s page theme and/or the row of social icons under their name. Themes: cutroom (Cutroom, open to all), daylight (Daylight, open to all), ink (Ink, any plan), blush (Blush, any plan), slate (Slate, any plan), paper (Paper, any plan), dune (Dune, any plan), sorbet (Sorbet, any plan), matcha (Matcha, any plan), lavender (Lavender, any plan), lido (Lido, any plan), olive (Olive, any plan), midnight (Midnight, any plan), clay (Clay, any plan), tangerine (Tangerine, any plan), aerochrome (Aerochrome, Plus plan and up), darkroom (Darkroom, Plus plan and up), kodachrome (Kodachrome, Plus plan and up), noir (Noir, Plus plan and up), neon (Neon diner, Plus plan and up), sunset (Lagos sunset, Plus plan and up), polaroid (Polaroid, Plus plan and up), super8 (Super 8, Plus plan and up), chroma (Chroma key, Plus plan and up), cyanotype (Cyanotype, Plus plan and up), velvet (Velvet, Plus plan and up), riso (Riso, Plus plan and up), glass (Glass, Plus plan and up), marquee (Marquee, Plus plan and up), lightbox (Lightbox, Plus plan and up), dusk (Dusk, Plus plan and up). Without a plan a page has two themes, Cutroom and Daylight, no picture or clip of its own at the top (topUpload) and keeps the address it was given. Any other theme saves on any plan but shows as Cutroom or Daylight until they are on a plan, and a Pro theme as its free twin until they are on Plus or above. Every theme has its own picture or clip for the top. top sets what fills the top of the page: best (their featured piece, or their first clip or picture, with their name over it; their work only while My work is on and open to all; with no work there, the theme’s own picture or clip) or none (no picture; the name on the theme’s colours). topFrom puts a picture or clip of theirs there instead, by its useAs: one they made (a create tool’s answer, or GET /api/v1/library, gives it) or uploaded; a picture they made goes at the top on any plan, one they uploaded needs a plan. topUpload takes an upload by its id from GET /api/v1/library (tab "uploads"); upload one first with POST /api/v1/files. Socials replace the whole row, in order: each {platform, url}, where url may be an @name for platforms with profile addresses. layout sets how the whole page is built: hero (Your picture or clip across the top with your name over it, then your blocks. Open to all.) classic (Your photo in a circle and everything centred, with no big picture. Open to all.) banner (A strip of your picture across the top, your photo over its edge, everything centred under it. Any plan.) card (Your picture fills the screen and the page sits on it as one card. Any plan.) reel (Your clips first, upright in a row that swipes sideways, then your links. Any plan.) grid (Your work as a grid of squares, like a profile, with Work, Shop and Links tabs on a phone. Any plan.) editorial (Your name set large, your links as a numbered list, your work with captions. Any plan.) split (On a laptop your picture holds the left half while the page scrolls on the right. Any plan.) Without a plan a page has Hero and Classic; another layout saves but the page shows Hero until they are on a plan. Every theme works in every layout. hide sets the parts of the top they leave out, the whole list each time ([] shows them all): photo (Your photo), handle (Your @handle), line (What you do and where), bio (Bio), socials (Social icons), label (The clip’s name), subscribe (Subscribe button), share (Share and QR code). Their name always shows; a block is turned off with PATCH /api/v1/page/blocks/{blockId}. Free, on every plan. focus is the point of the top picture that always stays in view, like a face or a product: {x, y} as fractions of the picture from its top-left ({x: 0.5, y: 0.25} keeps the upper middle). Every layout crops the picture round it, on phones and laptops alike; null goes back to each layout’s own crop. A new picture at the top clears it, so set it after choosing the picture. On a laptop every layout reads as a website: a bar with their name, their sections and Share, the layout’s top across the window, then the blocks in sections (named after their own header blocks, else after what they hold), a shop up to four across and links up to four across.

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

Body

  • themestringA theme id from the list above.
  • layoutstringHow the page is built, from the list above.heroclassicbannercardreelgrideditorialsplit
  • socialsobject[] · up to 12The icons, in order. Platforms: instagram, tiktok, youtube, x, threads, facebook, linkedin, snapchat, pinterest, twitch, discord, whatsapp, telegram, spotify, soundcloud, behance, dribbble, github, email, website.
    • platformstringrequired—instagramtiktokyoutubexthreadsfacebooklinkedinsnapchatpinteresttwitchdiscordwhatsapptelegramspotifysoundcloudbehancedribbblegithubemailwebsite
    • urlstringrequired—
  • topstringWhat fills the top of the page: best (their best work) or none.bestnone
  • topUploadstringA picture or clip they uploaded, by its id from GET /api/v1/library (tab "uploads"), to fill the top.
  • topFromobject · kind library | uploadA picture or clip of theirs to fill the top, by its useAs: one they made (a create tool’s answer gives it) or uploaded.
  • hidestring[] · up to 8The parts of the top to leave out, the whole list; [] shows them all.
  • focusobject | nullThe point of the top picture that always stays in view; null for each layout’s own crop.

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 pageGET/short-links