API7 Docs

Delete a plugin metadata on a gateway group

DELETE /apisix/admin/plugin_metadata/{plugin_name}

DELETE /apisix/admin/plugin_metadata/{plugin_name}

Interactive request editor loads with JavaScript.

Authorization

X-API-KEY<token>

In: header

Path Parameters

plugin_name*string

Name of the plugin.

Length1 <= length <= 64

Query Parameters

gateway_group_id*string

Gateway group ID. Optional when using the gateway group admin key to authenticate.

Length1 <= length

Response Body

application/json

application/json

curl -X DELETE "$API_BASE_URL/apisix/admin/plugin_metadata/string?gateway_group_id=86fb9981-d9d2-4555-9df8-91ae92129335"

Operation completed successfully with no response body.

""
Complete operation details and schema variants

DELETE /apisix/admin/plugin_metadata/{plugin_name}

Delete a plugin metadata on a gateway group

Delete metadata for a specific plugin type in the gateway group and revert to plugin defaults where applicable. Validate downstream plugin behavior after removal. Required IAM Permission: Action gateway:DeletePluginMetadata, Resource arn:api7:gateway:gatewaygroup/%s

Parameters

  • gateway_group_id (query, string, required): Gateway group ID. Optional when using the gateway group admin key to authenticate.
  • plugin_name (path, string, required): Name of the plugin.

Responses

  • 200: Operation completed successfully with no response body.
  • 400: Bad Request — The request was malformed or contained invalid parameters. Check the error_msg field for details.
  • value (object, optional): The specific resource.
  • error_msg (string, optional): The error message.

cURL

curl -X DELETE '$API_BASE_URL/apisix/admin/plugin_metadata/{plugin_name}'