Common embed error codes and messages

This document describes common error messages you may encounter when developing secure embeds.

General error codes

Error CodeDefinition
EEXISTDuplicate detected. This can be a duplicate team, user, etc.
EPERMThe requested operation is not permitted. Could indicate a lack of relevant workbook or account type permissions.
ESTALEStale object.
ENOENTObject does not exist.
EACCESPermission denied.
EINVALInvalid argument. Could indicate a URL parameter that doesn't exist.
ETIMEDOUTRequest timed out. Could indicate that the query didn't respond from warehouse in specified timeframe.
NETWORKUnable to connect to Sigma. This is typically a local network error.
UNKNOWNDefault API error message for all other errors.

Parameter-based error messages

CauseResulting error message in Sigma
Invalid embed_pathThe page you're looking for does not exist. Embed not found.
Invalid embed secretYou don't have permission to access this page. Invalid embed signature.
Invalid embed mode

Invalid embed request.

Check to ensure mode=userbacked when secure embedding.

Invalid clientIDYou don't have permission to access this page.
Invalid emailInvalid embed request. ":email" is not valid.
Invalid external_user_team

If the team is specified: The specified teams in ":external_user_team" do not exist. Please check spelling or create new teams in the admin portal.

If the team isn't specified: You don't have permission to access this page.

Session length has been exceededSession expired. Reload the page.
Invalid timeInvalid embed request. ":session_length" exceeds maximum