Command: create or replace one record set as a whole (records + TTL).

POST

/zones/{zoneId}/record-sets/upsert

curl --request POST \
  --url https://example.com/api/v1/zones/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/record-sets/upsert \
  --header 'Content-Type: application/json' \
  --cookie dnse_session=<dnse_session> \
  --data '{ "name": "www", "type": "A", "ttl": 0, "records": [ "example" ] }'

Authorizations

• session

Parameters

Path Parameters

zoneId

required

string format: uuid

Request Body^required

Media typeapplication/json

object

name

required

Relative name, apex = @

string

Example

www

type

required

string

Example

A

ttl

integer format: int64

0

records

required

Array<string>

>= 1 items

Responses

204

Desired state saved and enforced at the provider.

400

Malformed request.

Media typeapplication/json

object

error

required

string

Example^generated

{
  "error": "example"
}

404

Resource not found.

Media typeapplication/json

object

error

required

string

Example^generated

{
  "error": "example"
}

422

Blocked by a DNS validity rule or type validation (inline block).

Media typeapplication/json

object

error

required

string

Example^generated

{
  "error": "example"
}