Configure and manage Dynamic DNS for a domain

Set up and manage Dynamic DNS (DynDNS) for a specific domain. DynDNS is useful when your IP address changes regularly and you want your domain name to always point to the correct address. You need the domain ID, obtainable from endpoints like GET /api/client-domains.

Path Parameters

domainId integer · min: 1 required Example

Unique domain identifier

Headers

Accept Example

Content-Type Example

Body

required

application/json

hostname string required

record_type string · enum required

A

AAAA

Responses

200

success boolean

timestamp string

requestId string

data object

POST https://cloud.hostup.se/api/domains/{domainId}/dyndns

For AI assistants

cURL

curl -X POST "https://cloud.hostup.se/api/domains/20461/dyndns" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "hostname": "string",
    "record_type": "A"
  }'

Response

{
  "success": true,
  "timestamp": "string",
  "requestId": "string",
  "data": {
    "config": {
      "id": 0,
      "hostname": "string",
      "record_type": "string",
      "token": "string",
      "last_ip": "string",
      "last_update": "string",
      "update_count": 0,
      "enabled": true,
      "created_at": "string"
    },
    "message": "string"
  }
}

{
  "type": "object",
  "properties": {
    "success": {
      "type": "boolean"
    },
    "timestamp": {
      "type": "string"
    },
    "requestId": {
      "type": "string"
    },
    "data": {
      "type": "object",
      "properties": {
        "config": {
          "type": "object",
          "properties": {
            "id": {
              "type": "integer"
            },
            "hostname": {
              "type": "string"
            },
            "record_type": {
              "type": "string"
            },
            "token": {
              "type": "string"
            },
            "last_ip": {
              "type": "string",
              "nullable": true
            },
            "last_update": {
              "type": "string",
              "nullable": true
            },
            "update_count": {
              "type": "integer"
            },
            "enabled": {
              "type": "boolean"
            },
            "created_at": {
              "type": "string"
            }
          }
        },
        "message": {
          "type": "string"
        }
      }
    }
  }
}

Request Body

{
  "hostname": "string",
  "record_type": "A"
}