---
updatedAt: 2025-08-11T18:18:17.000Z
agentTools:
  projectIndex: https://docs.keycafe.com/llms.txt
---

# Error Codes

| Error Code                         | Description                                                                        |
| ---------------------------------- | ---------------------------------------------------------------------------------- |
| permission.duplicated              | A permission with the same details already exists.                                 |
| permission.group.notFound          | The group cannot be found.                                                         |
| permission.group.id.required       | The group ID is required if the group object is included in the request.           |
| permission.id.required             | The permission ID was not included in the request.                                 |
| permission.item.ambiguous          | Specify only one of: group ID, key ID, or location ID to grant access.             |
| permission.item.id.required        | A group ID, key ID, or location ID must be specified to grant access.              |
| permission.key.id.required         | The key ID is required if the key object is included in the request.               |
| permission.key.notFound            | The key cannot be found.                                                           |
| permission.location.id.required    | The location ID is required if the location object is included in the request.     |
| permission.location.notFound       | The location cannot be found.                                                      |
| permission.notFound                | The permission cannot be found.                                                    |
| permission.resource.forbidden      | SmartBox users can only be granted Exchange Only permission to a key or key group. |
| permission.role.forbidden          | SmartBox users can only be granted Exchange Only permission to a key or key group. |
| permission.role.invalid            | The specified permission role is not valid.                                        |
| permission.role.required           | The role was not included in the request.                                          |
| permission.search.group.invalid    | The specified group ID is not valid.                                               |
| permission.search.key.invalid      | The specified key ID is not valid.                                                 |
| permission.search.location.invalid | The specified location ID is not valid.                                            |
| permission.search.user.invalid     | The specified user ID is not valid.                                                |
| permission.user.notFound           | The user cannot be found.                                                          |
| permission.user.required           | The user object was not included in the request.                                   |
| permission.user.self.error         | Cannot assign permission to your own resource.                                     |