Skip to main content
PATCH
Update domain record

Authorizations

Authorization
string
header
required

Session access JWT or an API token (insta_<prefix>_<secret>).

Path Parameters

orgId
string<uuid>
required
domainName
string
required
recordId
string
required

the id from the records list

Pattern: ^[0-9]{1,18}$

Body

application/json
type
enum<string>
Available options:
A,
AAAA,
ANAME,
CNAME,
MX,
NS,
SRV,
TXT
host
string

relative to the domain: "@" for the domain itself, "api" for api.; the full hostname is accepted too

answer
string

an IPv4 (A) or IPv6 (AAAA) address; a hostname (CNAME, ANAME, NS, MX); " " (SRV); text (TXT). "." is the null MX and the no-service SRV target

ttl
integer

seconds

Required range: 300 <= x <= 604800
priority
integer

required for MX and SRV, refused for every other type

Required range: 0 <= x <= 65535

Response

Default Response

id
integer
required

the registrar's id for the record; the handle every write takes

type
enum<string>
required
Available options:
A,
AAAA,
ANAME,
CNAME,
MX,
NS,
SRV,
TXT
host
string
required

relative to the domain: "@" is the domain itself, "api" is api.

fqdn
string
required
answer
string
required
ttl
integer
required

seconds

managed
boolean
required

published by InstaCloud: read-only while hostname names the attached hostname it serves; without one, a leftover no hostname claims, which may be deleted

priority
integer

MX and SRV only

hostname
string

the attached hostname a managed record serves