VM Isos endpoints (Admin API)
7 FeatherPanel Admin API endpoints from admin/vm-isos.php: methods, paths, auth, permissions, rate limits, parameters and responses.
Last synced from FeatherPanel 3faf369 on .
On this page
Defined in backend/app/routes/admin/vm-isos.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/vm-isos
List library ISOs
| Parameter | In | Type | Required | Description |
|---|---|---|---|---|
kind | query | string | no | |
approval | query | string | no | |
search | query | string | no |
curl -X GET "$PANEL_URL/api/admin/vm-isos" \
-H "Authorization: Bearer $FEATHERPANEL_API_KEY" \
-H "Accept: application/json"Responses: 200 ISO rows
GET/api/admin/vm-isos/scan
List ISO files on a VDS node
| Parameter | In | Type | Required | Description |
|---|---|---|---|---|
vm_node_id | query | integer | yes |
curl -X GET "$PANEL_URL/api/admin/vm-isos/scan?vm_node_id=$VM_NODE_ID" \
-H "Authorization: Bearer $FEATHERPANEL_API_KEY" \
-H "Accept: application/json"Responses: 200 ISO files
POST/api/admin/vm-isos
Add a provider ISO to the library
curl -X POST "$PANEL_URL/api/admin/vm-isos" \
-H "Authorization: Bearer $FEATHERPANEL_API_KEY" \
-H "Accept: application/json"Responses: 201 Created
PATCH/api/admin/vm-isos/{id}
Update a library ISO
| Parameter | In | Type | Required | Description |
|---|---|---|---|---|
id | path | integer | yes |
curl -X PATCH "$PANEL_URL/api/admin/vm-isos/$ID" \
-H "Authorization: Bearer $FEATHERPANEL_API_KEY" \
-H "Accept: application/json"Responses: 200 Updated
DELETE/api/admin/vm-isos/{id}
Remove a library entry (user ISOs: also deletes the file)
| Parameter | In | Type | Required | Description |
|---|---|---|---|---|
id | path | integer | yes |
curl -X DELETE "$PANEL_URL/api/admin/vm-isos/$ID" \
-H "Authorization: Bearer $FEATHERPANEL_API_KEY" \
-H "Accept: application/json"Responses: 200 Deleted
POST/api/admin/vm-isos/{id}/approve
Approve a user ISO
| Parameter | In | Type | Required | Description |
|---|---|---|---|---|
id | path | integer | yes |
curl -X POST "$PANEL_URL/api/admin/vm-isos/$ID/approve" \
-H "Authorization: Bearer $FEATHERPANEL_API_KEY" \
-H "Accept: application/json"Responses: 200 Approved
POST/api/admin/vm-isos/{id}/reject
Reject a user ISO and delete its file
| Parameter | In | Type | Required | Description |
|---|---|---|---|---|
id | path | integer | yes |
curl -X POST "$PANEL_URL/api/admin/vm-isos/$ID/reject" \
-H "Authorization: Bearer $FEATHERPANEL_API_KEY" \
-H "Accept: application/json"Responses: 200 Rejected