Reference
Error Codes Complete reference of alice error codes with causes, fixes, and troubleshooting links
TL;DR
When alice encounters an error, it returns a code like SKILL_NOT_FOUND or SOURCE_AUTH_EXPIRED in the Slack response or dashboard logs. This page lists every error code, what causes it, and how to fix it. Each code links to the relevant troubleshooting guide for detailed steps.
Every error in alice includes a machine-readable error code. You will see these in Slack error responses, dashboard log entries, and scheduled report failure notifications.
Code Message Cause Fix SLACK_NOT_INSTALLEDSlack bot not installed The alice bot has not been added to your workspace Install from Settings > Workspace . See Slack Not Responding . SKILL_NOT_FOUNDUnknown command No skill matches the slug you typed Run /alice help to see available skills. Check for typos. COMMAND_PARSE_ERRORCould not parse command Invalid flag syntax in the command Use --key=value format. Run /alice skill --help for valid parameters. INVALID_PARAMETERInvalid parameter value A parameter value does not match the expected type Check parameter types with --help. Example: --days expects a number. MISSING_PARAMETERRequired parameter missing A required parameter was not provided Run /alice skill --help to see required parameters.
Code Message Cause Fix NO_SOURCESNo sources connected No data sources are connected to the workspace Connect Stripe or Connect Supabase .SOURCE_NOT_FOUNDSource not found The skill references a source that no longer exists Edit the skill and select a valid source. SOURCE_AUTH_EXPIREDSource credentials expired The OAuth token for a source has expired or been revoked Go to Dashboard > Sources and click Reconnect . SOURCE_CONNECTION_FAILEDCannot connect to source The source service is unreachable (outage or network issue) Check Stripe Status or Supabase Status . Retry in a few minutes. SOURCE_OAUTH_FAILEDOAuth authorization failed The OAuth flow was interrupted or denied Retry the connection from Dashboard > Sources . Use a non-incognito browser window. SOURCE_ALREADY_CONNECTEDSource already connected A source of this type is already connected Each workspace has one connection per source type. See Sources .
Code Message Cause Fix QUERY_SYNTAX_ERRORSQL syntax error The Raw SQL query has a syntax error Check the query in the skill builder Test panel. QUERY_TIMEOUTQuery execution timed out The query took longer than the 30-second limit Add filters, reduce the date range, or add a LIMIT clause. QUERY_WRITE_REJECTEDWrite operation rejected The query contains a non-SELECT statement All queries must be read-only. Remove INSERT, UPDATE, DELETE, or DROP statements. TABLE_NOT_FOUNDTable does not exist The query references a table that does not exist in the database Check the table name in the Supabase Dashboard. COLUMN_NOT_FOUNDColumn does not exist The query references a column that does not exist Check column names in the Supabase Table Editor. JOIN_KEY_MISMATCHCombined query join failed The join key field does not exist in one of the source results Verify that both source queries return the join key field. See Combined Queries . STRIPE_API_ERRORStripe API returned an error The Stripe API rejected the request Check the detailed error in Dashboard > Logs . May indicate permission issues or invalid parameters.
Code Message Cause Fix RATE_LIMITEDToo many requests Exceeded the per-hour execution limit Wait a few minutes. Default: 30 executions/hour. See Limits . QUERY_LIMIT_EXCEEDEDMonthly query limit reached Exceeded the monthly query limit (Free plan: 50 hard limit) Upgrade to Pro or wait for the next billing cycle.FEATURE_NOT_AVAILABLEFeature requires upgrade The feature is not available on your current plan Check Plans for feature availability. SKILL_LIMIT_REACHEDSkill limit reached Cannot create more skills on current plan Delete unused skills or upgrade . SOURCE_LIMIT_REACHEDSource limit reached Cannot connect more sources on current plan Free allows 1 source, Pro allows 3. Upgrade . MONITOR_LIMIT_REACHEDMonitor limit reached Cannot create more monitors on current plan Free allows 3, Pro allows 25. Upgrade .
Code Message Cause Fix PERMISSION_DENIEDInsufficient role Your role does not allow this action See Permission Denied for role requirements. ADMIN_REQUIREDAdmin role required Action requires admin or owner role Ask your workspace owner to promote you. OWNER_REQUIREDOwner role required Action requires owner role (billing, org deletion) Only the workspace owner can perform this action.
Code Message Cause Fix CHANNEL_NOT_FOUNDSlack channel not found The target channel was deleted or renamed Update the channel in the skill's trigger configuration. CHANNEL_NOT_MEMBERBot not in channel alice is not a member of the target channel Type /invite @alice in the channel. See Scheduled Report Missing . SCHEDULE_INVALIDInvalid cron expression The cron expression is malformed Check the syntax. Use presets in the Schedule step or validate at crontab.guru . MONITOR_COOLDOWNAlert suppressed by cooldown The condition was met but the cooldown period has not elapsed This is expected behavior. Adjust cooldown in the Trigger step if needed.
Code Message Cause Fix ACTION_FAILEDAction execution failed The underlying API call failed (e.g., Stripe tag) Check Dashboard > Logs for the detailed error. The source may need reconnecting. ACTION_NOT_AVAILABLEActions not available on plan Actions require the Pro plan or higher Upgrade to Pro .ACTION_TARGET_NOT_FOUNDTarget entity not found The customer, user, or entity no longer exists The data may have changed since the query ran. Re-run the skill for fresh results.
Every skill and action execution in Dashboard > Logs includes:
Status -- success or errorError code -- The machine-readable code from this pageError message -- A human-readable descriptionDuration -- How long the execution ran before failingSource -- Which source was being queried when the error occurred
Use the log filters to find errors: filter by status error and optionally by skill name or date range.