Delete Proxy Key
Delete a specific proxy key permanently
Overview
Permanently delete a specific proxy key. This action cannot be undone, and the proxy key will immediately stop working for all API requests.
Path Parameters
The proxy key ID to delete (starts with ek-proxy-)
Important Considerations
Immediate Effect: The proxy key stops working immediately after deletion. Any applications using this key will start receiving authentication errors.
Irreversible: Deletion is permanent. You cannot recover a deleted proxy key - you’ll need to create a new one.
Credit Recovery: Any unused credits allocated to the proxy key are returned to your main account balance.
Before Deleting
Make sure to:
- Update Applications: Remove or replace the proxy key in any applications that use it
- Check Dependencies: Verify no critical services depend on this specific key
- Document Changes: Record the deletion for audit purposes
- Backup Configuration: Save the key’s settings if you might need to recreate it later
Bulk Operations
To delete all proxy keys at once, use the Delete All Proxy Keys endpoint instead.
Use Cases
Security Incident
Quickly revoke access when a key is compromised
Project Completion
Clean up keys when projects are finished
Team Changes
Remove access when team members leave
Key Rotation
Delete old keys as part of regular security practices
Error Codes
Unauthorized - Invalid or missing API key
Forbidden - You don’t have permission to delete this proxy key
Not Found - Proxy key doesn’t exist or was already deleted
Rate Limited - Too many requests, please slow down
Alternative: Toggle Status
If you want to temporarily disable a proxy key instead of permanently deleting it, consider using the Toggle Proxy Key Status endpoint instead. This allows you to disable and re-enable keys as needed.
Authorizations
Enter your API key (starts with 'ek-')
Path Parameters
Proxy key ID
Response
Proxy key deleted successfully
The response is of type object.