App Domains

Claim App Domain

Claim a hostname and return the TXT record proving you control it.

409 when another app already holds the host. Hostnames are globally unique, and a silent overwrite would let one builder take another's traffic -- which is why claim_domain raises rather than upserting.

post/apps/{app_id}/domains

Request

  • Base URL: https://be.graph8.com/api/v1
  • URL: https://be.graph8.com/api/v1/apps/{app_id}/domains
  • Auth: HTTP bearer

Path parameters

app_idstring required

Headers

Authorizationstring nullable
X-Org-Idstring nullable

Request body

hostnamestring required

The hostname to serve this app on. Normalized server-side: case, a trailing dot and unicode all resolve to one canonical form.

Response

Successful Response

Changes

No recorded changes to this operation across all 2 revisions of this API.