Atlas
Platform Admin — Custom Domains

Register a custom domain

SaaS only. Register a custom domain for a workspace via Railway. Returns CNAME target for DNS setup.

POST
/api/v1/platform/domains

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X POST "http://localhost:3001/api/v1/platform/domains" \  -H "Content-Type: application/json" \  -d '{    "workspaceId": "org-abc123",    "domain": "data.customer.com"  }'
{
  "id": "string",
  "workspaceId": "string",
  "domain": "string",
  "status": "pending",
  "railwayDomainId": "string",
  "cnameTarget": "string",
  "certificateStatus": "PENDING",
  "createdAt": "string",
  "verifiedAt": "string"
}
{
  "error": "string",
  "message": "string",
  "requestId": "string"
}
{
  "property1": null,
  "property2": null
}
{
  "property1": null,
  "property2": null
}
{
  "error": "string",
  "message": "string",
  "requestId": "string"
}
{
  "error": "string",
  "message": "string",
  "requestId": "string"
}
{
  "error": "string",
  "message": "string",
  "requestId": "string"
}
{
  "error": "string",
  "message": "string",
  "requestId": "string"
}