Hot-Reload Plugins
PUT /apisix/admin/plugins/reload
PUT /apisix/admin/plugins/reloadInteractive request editor loads with JavaScript.
X-API-KEY<token>
Admin API key configured in config.yaml under deployment.admin.admin_key. You can also pass the key as a query parameter api_key or cookie x_api_key.
In: header
Response Body
application/json
application/json
curl -X PUT "http://127.0.0.1:9180/apisix/admin/plugins/reload"Successful response.
"done"**Unauthorized** — The API key is missing, invalid, or lacks permission.
{
"error_msg": "failed to check token",
"description": "missing apikey"
}{
"error_msg": "failed to check token",
"description": "wrong apikey"
}{
"error_msg": "failed to check token",
"description": "invalid method for role viewer"
}Complete operation details and schema variants
PUT /apisix/admin/plugins/reload
Hot-Reload Plugins
Trigger a hot reload of all plugins. This re-reads plugin configurations from etcd without restarting APISIX.
Important: Only the PUT method is accepted.
Parameters
Responses
200: Successful response.401: Unauthorized — The API key is missing, invalid, or lacks permission.error_msg(string, required): Authentication error message.description(string, optional): Detailed reason for the authentication failure.
cURL
curl -i http://127.0.0.1:9180/apisix/admin/plugins/reload \
-H 'X-API-KEY: your-api-key' -X PUT