Cloady Docs
API ReferenceEndpointsWorkspaces

Add a DNS record

Adds a record to a domain registered through Cloady in this workspace, or under an application's cloady.io address. On a registered domain, A, AAAA, ALIAS and CNAME records on the domain itself and on `*` are Cloady's. Under an address, records go on a name below it, like `mail` or `_verify`, and ALIAS, CAA and NS aren't allowed; the first one also gives the address itself a CNAME to Cloady, because a name with records below it no longer matches the wildcard. Records reach the internet within the TTL; a record the registrar refuses, such as a CNAME beside other records on the same name, answers 400 with its reason. Needs the developer role.

POST
/api/workspaces/{workspaceSlug}/domains/{domain}/records
AuthorizationBearer <token>

Personal API token (cldy_…)

In: header

Path Parameters

workspaceSlug*string
domain*string

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

curl -X POST "https://example.com/api/workspaces/string/domains/string/records" \  -H "Content-Type: application/json" \  -d '{    "name": "string",    "type": "A",    "content": "string"  }'
{  "record": {    "id": "string",    "name": "string",    "type": "string",    "content": "string",    "ttl": -9007199254740991,    "prio": -9007199254740991,    "managed": true  }}