API7 Docs

Delete Provider Key

DELETE /provider_keys/{provider_key_id}

DELETE /provider_keys/{provider_key_id}

Interactive request editor loads with JavaScript.

Authorization

BearerAdminToken
AuthorizationBearer <token>

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*string

Provider key ID.

Formatuuid

Response 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"
}
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 to DELETE /provider_keys/{provider_key_id}, response 400 above.

  • 403: Authenticated request is not permitted. Response fields (application/json): identical to DELETE /provider_keys/{provider_key_id}, response 400 above.

  • 404: Resource not found. Response fields (application/json): identical to DELETE /provider_keys/{provider_key_id}, response 400 above.

  • 409: Request conflicts with current resource state. Response fields (application/json): identical to DELETE /provider_keys/{provider_key_id}, response 400 above.

cURL

curl -X DELETE '$AISIX_CP/provider_keys/{provider_key_id}' -H 'Authorization: Bearer $AISIX_TOKEN'