Domains

Change how a domain behaves

Select this domain as primary, restore the managed default hostname, answer this hostname with a whole-host redirect, or pass hostname to swap which half of an apex/www pair serves the Space.

patch/v1/spaces/{spaceId}/domains/{domainId}

Request

  • Base URL: https://api.spacefast.com
  • URL: https://api.spacefast.com/v1/spaces/{spaceId}/domains/{domainId}
  • Auth: one of:
    • HTTP bearer
    • HTTP bearer
    • OAuth 2 (authorization code, authorization URL https://api.spacefast.com/v1/auth/oauth2/authorize, token URL https://api.spacefast.com/v1/auth/oauth2/token; client credentials, token URL https://api.spacefast.com/v1/auth/oauth2/token, scopes: domains:write)

Path parameters

spaceIdstring required
domainIdstring required

Request body

hostnamestring

Which of this attachment's two hostnames serves the Space. Accepts the apex or its www twin; the other one answers a 308 to it. Any other hostname is refused.

primaryboolean

Set or clear this hostname as the Space's primary URL.

Response

Response for status 200

$schemastring uri

Canonical JSON Schema URL for this response body. The server also sends it in the Link: rel="describedby" response header.

Changes

No recorded changes to this operation across all 1 revision of this API.