Skip to content
Systey

Replace DNS records and set DNSSEC

Request, parameters and responses for this API endpoint.

PUT/api/v1/customer/products/{id}/domain/dns

Overview

This endpoint requires an API key with write access. Its creator must still be the user of the customer account.

Headers & parameters

AuthorizationBearer $SYSTEY_API_KEY · required

Content-Typeapplication/json

idpath · required

{"type":"string","format":"uuid"}

Idempotency-Keyheader · required

{"type":"string","format":"uuid"}

Use a new UUID per action. Reuse the same UUID and content for retries.

Request body

Send a JSON object. Required fields refer to their containing object. Business requirements for the endpoint also apply; unknown fields are rejected.

Schema fields and requirements
FieldTypeRequired
records

maxItems: 200

arrayYes
records[]object—
records[].namestringYes
records[].type

"A" | "AAAA" | "CNAME" | "MX" | "TXT" | "SRV" | "CAA" | "ALIAS"

stringYes
records[].valuestringYes
records[].ttl

min: 60 · max: 86400

integerYes
records[].pref

min: 0 · max: 65535

integer—
dnssecbooleanYes

Example request

Replace placeholders with your own values. Persist $REQUEST_UUID before a mutation if this endpoint requires an Idempotency-Key.

cURL
curl -i -X PUT "https://systey.com/api/v1/customer/products/<resource UUID>/domain/dns" \
  -H "Authorization: Bearer $SYSTEY_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $REQUEST_UUID" \
  --data '{
  "records": [
    {
      "name": "@",
      "type": "A",
      "value": "203.0.113.10",
      "ttl": 3600
    }
  ],
  "dnssec": false
}'

Response

HTTP 200
Schema fields and requirements
FieldTypeRequired
dataobjectYes
data.messagestringYes

Errors

Error responses contain error and optionally message and details. Rate limit: 120 requests per minute per key. On HTTP 429 respect Retry-After.