TEASEDocs
API ReferenceLandings

List geo-segments for a domain

List the draft geo-segments for a domain, ordered by position. A segment buckets visitors by country (with optional device/OS/time/language conditions) and owns an ordered button stack. Requires a read-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.

Response Body

application/json

application/json

application/json

GET
/api/admin/segments/{domain}
curl -X GET "https://example.com/api/admin/segments/string"
{  "domain": "links.creator.com",  "items": [    {      "segment_id": "s_1a2b3c4d",      "domain": "links.creator.com",      "name": "Tier 1",      "countries": [        "US",        "GB",        "CA"      ],      "position": 0,      "is_default": false,      "match": null,      "ab": null,      "lang": "en"    },    {      "segment_id": "s_default0",      "domain": "links.creator.com",      "name": "Everyone else",      "countries": [],      "position": 1,      "is_default": true,      "match": null,      "ab": null,      "lang": ""    }  ]}
{  "detail": "auth required"}
{  "detail": {    "code": "domain_not_found",    "message": "Domain not found"  }}

Trigger custom-domain verification

Run the DNS-verify probe for a connecting custom domain and, when DNS is green, transition it to `active`. Requires a write-scoped key.

Create a geo-segment

Create a draft geo-segment for a domain. The first segment created becomes the catch-all default. Requires a write-scoped key.