Common embed error codes and messages

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

General error codes

Error Code	Definition
EEXIST	Duplicate detected. This can be a duplicate team, user, etc.
EPERM	The requested operation is not permitted. Could indicate a lack of relevant workbook or account type permissions.
ESTALE	Stale object.
ENOENT	Object does not exist.
EACCES	Permission denied.
EINVAL	Invalid argument. Could indicate a URL parameter that doesn't exist.
ETIMEDOUT	Request timed out. Could indicate that the query didn't respond from warehouse in specified timeframe.
NETWORK	Unable to connect to Sigma. This is typically a local network error.
UNKNOWN	Default API error message for all other errors.

Cause	Resulting error message in Sigma
Invalid embed_path	The page you're looking for does not exist. Embed not found.
Invalid embed secret	You 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 clientID	You don't have permission to access this page.
Invalid email	Invalid 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 exceeded	Session expired. Reload the page.
Invalid time	Invalid embed request. ":session_length" exceeds maximum