TEASEDocs
API ReferenceLandings

Create a button

Create a draft button in a segment. The button id is generated automatically when omitted, and the SVG label is rendered from `text_value`. 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

Path Parameters

domain*string

The domain hostname.

tier*string

The segment id to add the button to.

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

application/json

POST
/api/admin/buttons/{domain}/{tier}
curl -X POST "https://example.com/api/admin/buttons/string/string" \  -H "Content-Type: application/json" \  -d '{    "url": "https://onlyfans.com/creator/trial",    "icon": "of.svg",    "text_value": "Free trial"  }'
{  "button_id": "b_9f8e7d6c",  "domain": "links.creator.com",  "tier": "s_1a2b3c4d",  "position": 0,  "label": "Free trial",  "url": "https://onlyfans.com/creator/trial",  "icon": "of.svg",  "text_filename": "label_42_a1b2c3d4.svg",  "text_value": "Free trial",  "hidden": false,  "match": null,  "variants": null}
{  "detail": {    "code": "icon_unknown",    "message": "Icon 'of.svg' is not in the library"  }}
{  "detail": "auth required"}
{  "detail": {    "code": "domain_not_found",    "message": "Domain not found"  }}
{  "detail": {    "code": "button_id_taken",    "message": "Кнопка с id 'b_9f8e7d6c' уже существует в links.creator.com/s_1a2b3c4d"  }}

List buttons in a segment

List the draft buttons in one segment of a domain, ordered by position. The `tier` path parameter carries the segment id. Requires a read-scoped key.

Update a button

Update a draft button's label, url, icon, text, hidden flag, conditions, or A/B variants. Only provided fields change; changing the text re-renders the SVG label. Requires a write-scoped key.