Update Tracking Domain

post

https://api.aurorasendcloud.com/api/trackDomain/update

Update configuration of an existing tracking domain, including track name and SSL certificate information. Renaming is rejected when CNAME has already passed (41020); a new name must not equal an existing sending domain (41203) and must be unique per account (41202). Switching to auto certificate creates a Cloudflare hostname (41217 on failure); switching to manual deletes it. Renaming an auto-certificate domain recreates the Cloudflare hostname.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Form Data

integer

required

Track ID (single). Required (40029 if empty); must resolve to a tracking domain of the caller (41018 otherwise).

name

string

length between 4 and 255

^([a-zA-Z0-9][a-zA-Z0-9\-]{0,46}[a-zA-Z0-9]{0,1}\.)+([a-zA-Z0-9]+)$

New track name (optional; omit to keep current name). Same constraints as add: 4-255 characters total, each dot-separated label no more than 48 characters. Rejected when CNAME already passed (41020), when it equals a sending domain (41203), or when it already exists (41202).

autoCertificate

boolean

Optional. If omitted: keep current certificate mode. true: switch to automatic certificate. false: switch to manual certificate. If true, certContent and certKey may be omitted or empty. Note: a non-boolean string (e.g. yes) fails binding to null and is silently treated as "keep current mode" rather than rejected — always send literal true/false.

certContent

string

length ≤ 65530

Certificate content (PEM format). Consumed only when the target mode is manual: must be a standard PEM envelope (41205/41204 otherwise, 41206 over 65530 chars) and match the track domain (41214/41215).

certKey

string

length ≤ 8192

Certificate private key (PEM format). Consumed only when the target mode is manual: standard PEM envelope required (41208/41207, 41209 over 8192 chars), must pair with certContent (41212).

Responses

Language

Credentials

URL

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

200Request successful

400Business error. Note: server returns HTTP 200 with the business code in statusCode; the HTTP status here is a documentation placeholder. See error code table below for 40029/41001/41002/41003/41018/41020/41202/41203/41204-41218.