Core
Relays

Create a Custom Domain

Creates a custom domain for the Relay

post/relays/{relay_id}/custom-domains

Request

Path parameters

relay_idstring required

The id of the Relay to which the custom domain should be added.

Request body

customDomainstring required

The customer managed domain to which requests to be relayed to your domain should be sent.

Example request

{
  "customDomain": "subdomain.example.com"
}

Response

The custom domain has been created

idstring required

The unique identifier for the custom domain.

customDomainstring required

The customer managed domain to which requests to be relayed to your domain should be sent.

relaystring required

The ID of the Relay with which this custom domain is associated.

status'active' | 'inactive' required

The status of the domains DNS verification.

validationRecordstring uuidv4 required

Validation TXT record to be added on the _ev-custom-relay subdomain of your custom domain

createdAtinteger required

The exact time, in epoch milliseconds, when this custom domain was created.

updatedAtinteger required

The exact time, in epoch milliseconds, when this custom domain was last updated.

Example response

{
  "id": "custom_domain_j3od9Bl0WV1n",
  "customDomain": "subdomain.example.com",
  "status": "active",
  "validationRecord": "986f3008-86e7-4caf-bd8b-a5d312844153",
  "relay": "relay_destination_d4ja57js9lnh",
  "createdAt": 1692972623233,
  "updatedAt": 1692972623233
}

Changes

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