TEASEDocs
API ReferenceLandings

Reorder geo-segments

Set the evaluation/tab order of a domain's segments. The id list must exactly match the domain's current segment set. 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.

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

PUT
/api/admin/segments/{domain}/order
curl -X PUT "https://example.com/api/admin/segments/string/order" \  -H "Content-Type: application/json" \  -d '{    "order": [      "s_1a2b3c4d",      "s_default0"    ]  }'
{  "domain": "links.creator.com",  "items": [    {      "segment_id": "s_1a2b3c4d",      "domain": "links.creator.com",      "name": "Tier 1",      "countries": [        "US"      ],      "position": 0,      "is_default": false,      "match": null,      "ab": null,      "lang": "en"    }  ]}
{  "detail": {    "code": "order_mismatch",    "message": "Список id должен совпадать с текущим набором сегментов домена"  }}
{  "detail": "auth required"}
{  "detail": {    "code": "domain_not_found",    "message": "Domain not found"  }}

Delete a geo-segment

Delete a draft segment. The default segment cannot be deleted until another is promoted. Pass `force=true` to also delete buttons still in the segment. Requires a write-scoped key.

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.