TEASEDocs
API ReferencePages & Publish

Set button appearance, profile card & 18+ gate

Sets the landing-wide UI style for a domain, written to the draft state: the button appearance (buttons), the profile-card look (profile), and the optional 18+ sensitive-content gate (gate). Applies only while the domain uses a built-in (platform) design — an uploaded custom-HTML design owns its own look and never inherits these settings. Each section object replaces the stored section wholesale; null resets that section to the stock look. Unknown keys are rejected. Changing buttons.font re-renders every draft button label of the domain server-side (the response reports the count as relabeled). Requires a write-scoped key.

Authorization

bearerAuth
AuthorizationBearer <token>

Your al_live_<prefix>_<secret> API key. Mint and manage keys in the dashboard.

In: header

Query Parameters

domain*string

Registered hostname, e.g. onlydasha.com.

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

POST
/api/admin/bg/ui
curl -X POST "https://example.com/api/admin/bg/ui?domain=string" \  -H "Content-Type: application/json" \  -d '{    "buttons": {      "shape": "pill",      "fill": "solid",      "color": "#e0426e",      "animation": "breathe",      "anim_speed": "slow",      "font": "unbounded",      "align": "icon_left"    },    "profile": {      "name_font": "unbounded",      "name_size": 1.2,      "status_text": "Online now",      "bio": "18+ • daily drops",      "bio_font": "nunito",      "bio_size": 0.9    },    "gate": {      "enabled": true,      "mode": "cover",      "blur": true    }  }'
{  "domain": "onlydasha.com",  "ui": {    "buttons": {      "shape": "pill",      "fill": "solid",      "color": "#e0426e",      "animation": "breathe",      "anim_speed": "slow",      "font": "unbounded",      "align": "icon_left"    },    "profile": {      "name_font": "unbounded",      "name_size": 1.2,      "status_text": "Online now",      "bio": "18+ • daily drops",      "bio_font": "nunito",      "bio_size": 0.9    },    "gate": {      "enabled": true,      "mode": "cover",      "blur": true    }  },  "changed": true,  "relabeled": 4}
{  "detail": {    "code": "landing_ui_invalid",    "message": "buttons.shape: допустимо rounded, pill, square, sharp"  }}
{  "detail": "auth required"}
{  "detail": {    "code": "domain_not_found",    "message": "Домен 'onlydasha.com' не зарегистрирован"  }}

Set the desktop canvas color

Sets the per-domain solid backdrop color shown behind the phone-card on desktop, written to the draft state. Requires a write-scoped key.

Check if a background source exists

Probe that reports whether an un-edited background source image has been uploaded for the given domain and variant. Requires a read-scoped key.