DNS monitors

Retrieve all

GET https://uptime.hostbraza.com.br/api/dns-monitors/
curl --request GET \
--url 'https://uptime.hostbraza.com.br/api/dns-monitors/' \
--header 'Authorization: Bearer {api_key}' \
Parameters Details Description
page Optional Integer The page number that you want results from. Defaults to 1.
results_per_page Optional Integer How many results you want per page. Allowed values are: 10 , 25 , 50 , 100 , 250 , 500 , 1000. Defaults to 25. 
{ "data": [ { "id": 1, "project_id": 0, "name": "Sample", "target": "example.com", "dns": { "A": [ { "host": "example.com", "ip": "12.12.12.12" } ], "CNAME": [], "HINFO": [], "CAA": [], "MX": [], ... }, "notifications": [1], "settings": { "dns_check_interval_seconds": 300 }, "total_checks": 1, "total_changes": 0, "last_check_datetime": "2024-01-03 01:48:42", "next_check_datetime": "2024-01-03 01:49:13", "last_change_datetime": null, "is_enabled": true, "datetime": "2025-04-08 04:02:41" "last_datetime": null } ], "meta": { "page": 1, "results_per_page": 25, "total": 1, "total_pages": 1 }, "links": { "first": "https://uptime.hostbraza.com.br/api/dns-monitors?&page=1", "last": "https://uptime.hostbraza.com.br/api/dns-monitors?&page=1", "next": null, "prev": null, "self": "https://uptime.hostbraza.com.br/api/dns-monitors?&page=1" } }

Retrieve one

GET https://uptime.hostbraza.com.br/api/dns-monitors/{dns_monitor_id}
curl --request GET \
--url 'https://uptime.hostbraza.com.br/api/dns-monitors/{dns_monitor_id}' \
--header 'Authorization: Bearer {api_key}' \ 
{ "data": { "id": 1, "project_id": 0, "name": "Sample", "target": "example.com", "dns": { "A": [ { "host": "example.com", "ip": "12.12.12.12" } ], "CNAME": [], "HINFO": [], "CAA": [], "MX": [], ... }, "notifications": [1], "settings": { "dns_check_interval_seconds": 300 }, "total_checks": 1, "total_changes": 0, "last_check_datetime": "2024-01-03 01:48:42", "next_check_datetime": "2024-01-03 01:49:13", "last_change_datetime": null, "is_enabled": true, "datetime": "2025-04-08 04:02:41" "last_datetime": null } }

Create

POST https://uptime.hostbraza.com.br/api/dns-monitors
Parameters Details Description
name Required String -
target Required String -
project_id Optional Integer -
notifications Optional Array Notification handler ids
dns_check_interval_seconds Optional Integer Allowed values: 300, 600, 1800, 3600, 21600, 43200, 86400 (seconds)
dns_types Optional Array Allowed values: A, CNAME, CAA, MX, NS, SOA, TXT, AAAA
is_enabled Optional Boolean -
curl --request POST \
--url 'https://uptime.hostbraza.com.br/api/dns-monitors' \
--header 'Authorization: Bearer {api_key}' \
--header 'Content-Type: multipart/form-data' \
--form 'name=Example' \
--form 'target=example.com' \
{ "data": { "id": 1 } }

Update

POST https://uptime.hostbraza.com.br/api/dns-monitors/{dns_monitor_id}
Parameters Details Description
name Required String -
target Required String -
project_id Optional Integer -
notifications Optional Array Notification handler ids
dns_check_interval_seconds Optional Integer Allowed values: 300, 600, 1800, 3600, 21600, 43200, 86400 (seconds)
dns_types Optional Array Allowed values: A, CNAME, CAA, MX, NS, SOA, TXT, AAAA
is_enabled Optional Boolean -
curl --request POST \
--url 'https://uptime.hostbraza.com.br/api/dns-monitors/{dns_monitor_id}' \
--header 'Authorization: Bearer {api_key}' \
--header 'Content-Type: multipart/form-data' \
--form 'name=Example' \
{ "data": { "id": 1 } }

Delete

DELETE https://uptime.hostbraza.com.br/api/dns-monitors/{dns_monitor_id}
curl --request DELETE \
--url 'https://uptime.hostbraza.com.br/api/dns-monitors/{dns_monitor_id}' \
--header 'Authorization: Bearer {api_key}' \