Delete Provider Key
DELETE /provider_keys/{provider_key_id}
DELETE /provider_keys/{provider_key_id}Interactive request editor loads with JavaScript.
Authorization
BearerAdminToken Organization-scoped admin token. Read operations require a valid token, and write operations require a token with write permission.
In: header
Path Parameters
Provider key ID.
uuidResponse Body
application/json
application/json
application/json
application/json
application/json
application/json
curl -X DELETE "$AISIX_CP/provider_keys/$PROVIDER_KEY_ID" \ -H "Authorization: Bearer $AISIX_TOKEN"OK
{
"deleted": true,
"id": "497f6eca-6276-4993-bfeb-53cbbbba6f08"
}Request body or parameters failed validation.
{
"error": {
"code": "string",
"message": "string"
}
}Missing or invalid bearer.
{
"error": {
"code": "UNAUTHENTICATED",
"message": "no org context"
}
}Authenticated request is not permitted.
{
"error": {
"code": "CUSTOM_KEY_DISABLED",
"message": "custom API key values are disabled for this organization"
}
}Resource not found.
{
"error": {
"code": "NOT_FOUND",
"message": "provider key not found"
}
}Request conflicts with current resource state.
{
"error": {
"code": "CREDENTIAL_IN_USE",
"message": "models still reference this provider_key"
}
}Complete operation details and schema variants
DELETE /provider_keys/{provider_key_id}
Delete Provider Key
Deletes the provider key from every environment where it was allowed. Models that still reference the key cannot dispatch successfully, so rebind affected models before deleting the key.
Parameters
provider_key_id(path, string, required): Provider key ID.
Responses
-
200: OK -
deleted(boolean, required): Whether the provider key was deleted. -
id(string, required): UUID of the deleted provider_key. -
400: Request body or parameters failed validation. -
error(object, required): Error details. -
error.code(string, required): Machine-readable identifier. Examples:UNAUTHENTICATED,INVALID_REQUEST,MASTER_KEY_UNSET,INTERNAL. -
error.message(string, required): Human-readable explanation; safe to surface to operators. -
401: Missing or invalid bearer. Response fields (application/json): identical toDELETE /provider_keys/{provider_key_id}, response 400 above. -
403: Authenticated request is not permitted. Response fields (application/json): identical toDELETE /provider_keys/{provider_key_id}, response 400 above. -
404: Resource not found. Response fields (application/json): identical toDELETE /provider_keys/{provider_key_id}, response 400 above. -
409: Request conflicts with current resource state. Response fields (application/json): identical toDELETE /provider_keys/{provider_key_id}, response 400 above.
cURL
curl -X DELETE '$AISIX_CP/provider_keys/{provider_key_id}' -H 'Authorization: Bearer $AISIX_TOKEN'