​

Delete Protection

​

Overview

• Preventing accidental deletion of critical resources
• Requiring explicit confirmation to disable protection
• Blocking deletion attempts through both UI and API

​

Supported Resources

• Keyspaces: Protect your keyspace configurations and settings from accidental deletion

​

Enabling Keyspace Delete Protection

1. Navigate to your Keyspace Settings in the dashboard
2. Click “Enable Delete Protection”
3. Type the keyspace name to confirm
4. Click “Enable Keyspace Delete Protection” to add protection

​

Disabling Keyspace Delete Protection

1. Navigate to your Keyspace Settings in the dashboard
2. Click “Disable Delete Protection”
3. Type the keyspace name to confirm
4. Click “Disable Keyspace Delete Protection” to remove protection

​

Resource Behavior

• All deletion attempts are blocked
• The resource returns a DELETE_PROTECTED error
• The error includes a link to this documentation

​

Example API Error Response

{
  "error": {
    "code": "DELETE_PROTECTED",
    "docs": "https://unkey.com/docs/api-reference/errors/code/DELETE_PROTECTED",
    "message": "api [apiId] is protected from deletions",
    "requestId": "req_1234"
  }
}

​

Best Practices

1. Enable for Production resources: Always enable Delete Protection for resources in production
2. Use for Critical resources: Protect resources that contain important data or configurations
3. Regular Review: Periodically review protection status of your resources
4. Team Communication: Inform team members about protected resources
5. Documentation: Document which resources are protected and why

​

Limitations

• Delete Protection only prevents deletion of the resource
• It does not prevent modifications to the resource
• It does not prevent deletion of children of a resource, like keys or ratelimits that belong to a protected resource
• Protection can be disabled by any user with appropriate permissions

​

Related Errors

• DELETE_PROTECTED - Returned when attempting to delete a protected API