DNS Hosts endpoints (Admin API)
6 FeatherPanel Admin API endpoints from admin/dns-hosts.php: methods, paths, auth, permissions, rate limits, parameters and responses.
Last synced from FeatherPanel 15b94e9 on .
On this page
Defined in backend/app/routes/admin/dns-hosts.php. Authentication used here: Admin. Read Authentication for how to send credentials and Rate limits and errors for the response envelope.
Paths, methods, permissions and rate limits come from the route file. Summaries, parameters and response codes come from the OpenAPI annotations on the controllers; endpoints without annotations show only what the route file declares.
Endpoints
GET/api/admin/dns-hosts
List DNS hosts
curl -X GET "$PANEL_URL/api/admin/dns-hosts" \
-H "Authorization: Bearer $FEATHERPANEL_API_KEY" \
-H "Accept: application/json"GET/api/admin/dns-hosts/{id}
Show DNS host
| Parameter | In | Type | Required | Description |
|---|---|---|---|---|
id | path | - | yes |
curl -X GET "$PANEL_URL/api/admin/dns-hosts/$ID" \
-H "Authorization: Bearer $FEATHERPANEL_API_KEY" \
-H "Accept: application/json"PUT/api/admin/dns-hosts
Create DNS host
curl -X PUT "$PANEL_URL/api/admin/dns-hosts" \
-H "Authorization: Bearer $FEATHERPANEL_API_KEY" \
-H "Accept: application/json"Plugin events: featherpanel:admin:dns_hosts:host:created
PATCH/api/admin/dns-hosts/{id}
Update DNS host
| Parameter | In | Type | Required | Description |
|---|---|---|---|---|
id | path | - | yes |
curl -X PATCH "$PANEL_URL/api/admin/dns-hosts/$ID" \
-H "Authorization: Bearer $FEATHERPANEL_API_KEY" \
-H "Accept: application/json"Plugin events: featherpanel:admin:dns_hosts:host:updated
DELETE/api/admin/dns-hosts/{id}
Delete DNS host
| Parameter | In | Type | Required | Description |
|---|---|---|---|---|
id | path | - | yes |
curl -X DELETE "$PANEL_URL/api/admin/dns-hosts/$ID" \
-H "Authorization: Bearer $FEATHERPANEL_API_KEY" \
-H "Accept: application/json"Plugin events: featherpanel:admin:dns_hosts:host:deleted
POST/api/admin/dns-hosts/{id}/test
Test PowerDNS on DNS host web node
| Parameter | In | Type | Required | Description |
|---|---|---|---|---|
id | path | - | yes |
curl -X POST "$PANEL_URL/api/admin/dns-hosts/$ID/test" \
-H "Authorization: Bearer $FEATHERPANEL_API_KEY" \
-H "Accept: application/json"