toc

Functions Error Codes

Quickly resolve Functions errors.

Reference

If you received a failed response from the Function 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 function run timed out as it took too long to complete.

Resolution

Ensure all paths in your function complete within the timeout specified in the Functions reference.

decryption-error

Cause

This error indicates that there was an issue decrypting the data passed to the function.

Resolution

Ensure that the data being passed to the function was encrypted by the same team that owns the function.

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 function 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 function 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 Functions 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 Function is not present in the IP whitelist.

Resolution

Ensure that your Function’s IP whitelist is correctly defined and includes any tenants that you expect to invoke the Function.

run-token-validation-error

Cause

This error indicates that the run token used in the run request is failing to verify.

Resolution

Ensure that the run token being returned from the SDK has not been altered in any way.

run-token-expired

Cause

This error indicates that the run token used in the run request has expired. Run tokens have a time to live of five minutes.

Resolution

Ensure that the run token is used within 5 minutes of creation.

payload-verification-error

Cause

This error indicates that the payload in the run request does not match that used to create the run token.

Resolution

Ensure that the same payload is used when creating the run token and running the function.

run-token-used-error

Cause

This error indicates that the run token has already been used. Run tokens are single use only.

Resolution

Generate a new run token to be able to run the function again.


Was this page useful?