Creates a new relational domain (isolated table/view namespace, separate from KV and JSON domains).

POST

/store-api/rel/domains

curl --request POST \
  --url https://example.com/store-api/rel/domains \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{ "name": "example" }'

Authorizations

• bearer_auth

Request Body^required

Media typeapplication/json

object

name

required

Domain name (max 50 chars, [a-zA-Z0-9_-]; "domains" is reserved).

string

Example ^generated

{
  "name": "example"
}

Responses

201

Relational domain created

Media typeapplication/json

object

created_at

required

Creation timestamp (Unix seconds).

integer format: int64

name

required

string

state

required

Lifecycle state: “active” or “deleting” (background purge running). Always present — so a later list_domains visibility change (surfacing Deleting domains too) needs no REST-contract change.

string

Example ^generated

{
  "created_at": 1,
  "name": "example",
  "state": "example"
}

400

Invalid domain name

Media typetext/plain

string

409

Domain already exists

Media typetext/plain

string

503

Relational engine disabled

Media typetext/plain

string

507

Insufficient Storage — disk space or memory runs short; the write was not applied. Reads go on; retry after the seconds in Retry-After.

Media typetext/plain

string

Headers

Retry-After

integer