toc
Cages Error Codes
Quickly resolve Cages errors.
Reference
If you received a failed response from the Cage Run API that included an X-Evervault-Error-Code header or if you received a JSON response with an evervaultErrorCode field in the case of programmatic access, you can use this error code reference to help resolve the issue.
request-timeout
Cause
This error indicates that the cage run timed out as it took too long to complete.
Resolution
Ensure all paths in your cage complete within the timeout specified in the Cages reference.
decryption-error
Cause
This error indicates that there was an issue decrypting the data passed to the cage.
Resolution
Ensure that the data being passed to the cage was encrypted by the same team that owns the cage.
unauthorized
Cause
This error indicates that you are not authorized to access the resource you are requesting.
Resolution
Ensure that you have included the correct api key in your request.
bad-request
Cause
This error indicates that the server is unable (or refuses) to process the request sent by the client, due to an issue that is perceived by the server to be a client problem.
Resolution
A bad-request error is quite a vague error that doesn't indicate the exact issue but it is usually a client-side problem. Start by double checking that your cage name and version are correct.
If the issue persists, please contact support.
resource-not-found
Cause
This indicates that the API is unable to find the resource you have requested.
Resolution
The first step here would be to confirm that your cage name is correct. If that doesn't resolve your issue, please contact support.
internal-error
Cause
This error indicates that there was an issue with Cages itself.
Resolution
Try again in a few moments. If the issue persists, reach out to support.
forbidden-ip-error
Cause
This error indicates that the IP address of the client which invoked the Cage is not present in the IP whitelist.
Resolution
Ensure that your Cage’s IP whitelist is correctly defined and includes any tenants that you expect to invoke the Cage.