Skip to content

Create a Dynamic DNS entry

POST
/dynamic-dns/entries
curl --request POST \
--url https://sylve.lan:8181/api/dynamic-dns/entries \
--header 'Authorization: <Authorization>' \
--header 'Content-Type: application/json' \
--data '{ "enabled": true, "hostname": "example", "intervalMinutes": 1, "provider": "example", "providerSettings": { "additionalProperty": "example" }, "recordType": "example", "sourceSettings": { "additionalProperty": "example" }, "sourceType": "example", "token": "example" }'

Create and validate a Dynamic DNS entry

Dynamic DNS entry

Media typeapplication/json
object
enabled
boolean
hostname
string
intervalMinutes
integer
provider
string
providerSettings
object
key
additional properties
string
recordType
string
sourceSettings
object
key
additional properties
string
sourceType
string
token
string
Examplegenerated
{
"enabled": true,
"hostname": "example",
"intervalMinutes": 1,
"provider": "example",
"providerSettings": {
"additionalProperty": "example"
},
"recordType": "example",
"sourceSettings": {
"additionalProperty": "example"
},
"sourceType": "example",
"token": "example"
}

Created

Media typeapplication/json
object
data
object
consecutiveFailures
integer
createdAt
string
credentialConfigured
boolean
enabled
boolean
hostname
string
id
integer
intervalMinutes
integer
ipv4Error
string
ipv4Status
string
ipv6Error
string
ipv6Status
string
lastError
string
lastIPv4
string
lastIPv6
string
lastStatus
string
lastSuccessAt
string
lastSyncAt
string
nextRetryAt
string
provider
string
providerSettings
object
key
additional properties
string
recordType
string
sourceSettings
object
key
additional properties
string
sourceType
string
updatedAt
string
error
string
message
string
status
string
Examplegenerated
{
"data": {
"consecutiveFailures": 1,
"createdAt": "example",
"credentialConfigured": true,
"enabled": true,
"hostname": "example",
"id": 1,
"intervalMinutes": 1,
"ipv4Error": "example",
"ipv4Status": "example",
"ipv6Error": "example",
"ipv6Status": "example",
"lastError": "example",
"lastIPv4": "example",
"lastIPv6": "example",
"lastStatus": "example",
"lastSuccessAt": "example",
"lastSyncAt": "example",
"nextRetryAt": "example",
"provider": "example",
"providerSettings": {
"additionalProperty": "example"
},
"recordType": "example",
"sourceSettings": {
"additionalProperty": "example"
},
"sourceType": "example",
"updatedAt": "example"
},
"error": "example",
"message": "example",
"status": "example"
}

Bad Request

Media typeapplication/json
object
data
error
string
message
string
status
string
Examplegenerated
{
"data": "example",
"error": "example",
"message": "example",
"status": "example"
}

Conflict

Media typeapplication/json
object
data
error
string
message
string
status
string
Examplegenerated
{
"data": "example",
"error": "example",
"message": "example",
"status": "example"
}

Payload Too Large

Media typeapplication/json
object
data
error
string
message
string
status
string
Examplegenerated
{
"data": "example",
"error": "example",
"message": "example",
"status": "example"
}

Internal Server Error

Media typeapplication/json
object
data
error
string
message
string
status
string
Examplegenerated
{
"data": "example",
"error": "example",
"message": "example",
"status": "example"
}

Bad Gateway

Media typeapplication/json
object
data
error
string
message
string
status
string
Examplegenerated
{
"data": "example",
"error": "example",
"message": "example",
"status": "example"
}