Skip to content

Delete encryption key

Request to delete an encryption key:

DELETE /api/v2/encrypt_keys/<key-id>.json

Access to the key must be revoked from all users first. Recordings encrypted with a deleted key cannot be played back anymore.

Response contains HTTP status code as shown in the following table.

Response Description
200 OK The encryption key has been successfully deleted
403 Forbidden The request cannot be completed because API user has no permission to delete encryption keys
404 Not Found The ID is not a valid UUID
409 Conflict

Users are still authorized to use the key:

{"error": "NotEmptyError", "explanation": "Other resources refer to this one", "details": "Could not delete encryption key because access to it is granted to other users. Revoke the access first"}