Get Started on Cloud
BasicsAI AgentsPipelinesActions & ServicesEnvironmentsIntegrationsTargetsTestsDomainsSandboxesTerraformTunnelsYAMLBuddy GitCLIAPIFAQ

Register

View as Markdown
  • POST
  • /workspaces
  • /:workspace
  • /domains
  • /register

Register a new domain. Deprecated: use POST /workspaces/{workspace_domain}/domains with type = REGISTERED

Request

REQUIRED SCOPES
DOMAIN_MANAGE
URL PARAMETERS
workspacerequiredstring
The human-readable ID of the workspace

Example: "my-company"

BODY PARAMETERS
namestring
The domain name to register
auto_renewboolean
Whether to enable auto-renewal for the domain
on_owner_behalfboolean
Whether to register the domain on the workspace owner's behalf

Response

RESPONSE BODY
typestring enum
The type of the domain
Allowed enum:
REGISTERED,
POINTED,
PRIVATE,
CLAIMED
urlread-onlystring
API endpoint to GET this object
html_urlread-onlystring
Web URL to view this object in Buddy.works
namestring
The name of the domain
idstring
The ID of the domain
pointed_viastring[]
auto_renewboolean
Whether the domain is set to auto-renew
transfer_lockboolean
Whether the domain has transfer lock enabled
dnssecboolean
Whether DNSSEC is enabled for the domain
expiry_datestring
The expiration date of the domain registration

Last modified on Jun 29, 2026

Previous pageCreate Private Domains from YAMLNext pageSearch

Request example

curl -X POST "https://api.buddy.works/workspaces/:workspace/domains/register" \
  -H "Authorization: Bearer <YOUR-TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "testdomain.pl",
  "auto_renew": true,
  "on_owner_behalf": false
}'