TEASEDocs
API ReferenceLandings

Register a landing domain

Register a new landing domain. The row is returned immediately in the `pending` state and domain provisioning runs asynchronously. 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

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/domains
curl -X POST "https://example.com/api/admin/domains" \  -H "Content-Type: application/json" \  -d '{    "hostname": "links.creator.com",    "display_name": "FB Agency"  }'
{  "hostname": "links.creator.com",  "display_name": "FB Agency",  "created_at": 1719772800,  "button_count": 0,  "infra_state": "pending",  "provisioning_error": null,  "infra_attempted_at": 1719772800}
{  "detail": {    "code": "invalid_request",    "message": "Invalid value for field."  }}
{  "detail": "auth required"}
{  "detail": {    "code": "domain_cap_reached",    "message": "Достигнут лимит доменов для вашего тарифа (3). Обновите тариф, чтобы добавить больше."  }}

List landing domains

List every landing domain in your account, each with its draft button count and infrastructure provisioning state. Requires a read-scoped key.

Rename a landing domain

Update a domain's editable metadata (currently the `display_name` shown in stats). Takes effect immediately without a publish. Requires a write-scoped key.