// API REFERENCE
Domains API
Generated from the OpenAPI 3.1 spec. Authenticate with a bearer sk_segal_… key.
GET/api/v1/domainsList domains
Parameters
| Param | Type | Required | Description |
|---|---|---|---|
| limit (query) | integer | no | Page size. |
| cursor (query) | string | no | Opaque pagination cursor from a prior response. |
Responses
- 200 — A page of domains.
- 401 —
Example
bash
curl -X GET https://api.segalcompute.com/api/v1/domains \
-H "Authorization: Bearer sk_segal_..."Try itSandbox · mock data
POST/api/v1/domainsRegister a domain
Parameters
| Param | Type | Required | Description |
|---|---|---|---|
| Idempotency-Key (header) | string | no | Makes a POST safe to retry; the same key returns the same result. |
Body
| Param | Type | Required | Description |
|---|---|---|---|
| name | string | yes | |
| region | string | no |
Responses
- 201 — The registered domain.
- 400 —
- 401 —
Example
bash
curl -X POST https://api.segalcompute.com/api/v1/domains \
-H "Authorization: Bearer sk_segal_..." \
-H "Content-Type: application/json" \
-d '{"name":"acme.dev","region":"us-west-1"}'Try itSandbox · mock data