databay-cli 0.1.0__py3-none-any.whl

databay/skill/references/errors.md

@@ -0,0 +1,727 @@
+# databay errors
+
+Generated by python/tools/gen_client.py from contract/core.json; do not edit.
+
+When output is captured, a failed command prints one JSON object on stderr:
+`{"error": {"code", "message", "hint", "next", "recovery", "context", ...}}`.
+Read `recovery.action` first; the exit code is the coarse class.
+
+## Exit codes
+
+| Exit | Meaning |
+|---|---|
+| 0 | ok |
+| 1 | the server refused; fix the input or ask a human |
+| 2 | usage: the command line is incomplete or inconsistent |
+| 3 | a profile or a token is needed |
+| 4 | still pending: run `next`, the same wait |
+| 5 | the wait ended in failure |
+| 6 | transient: retry later |
+| 7 | version mismatch: upgrade the side the message names |
+| 8 | the client is outdated or hit a bug: upgrade it or report it |
+| 9 | not ready: fix what the answer names, then check again |
+
+## Client codes
+
+| Code | Exit | Action | Side effects | Hint |
+|---|---|---|---|---|
+| `access_denied` | 3 | ask_human | none | The sign-in was refused in the browser. Run databay login again to retry. |
+| `cancelled` | 1 | ask_human | none | Nothing was changed. Run the command again and answer y. |
+| `confirmation_required` | 2 | ask_human | none | This command removes or overwrites state. Pass --yes once a human has agreed. |
+| `credential_missing` | 3 | do_first | none | The profile has no stored sign-in. Run the command `next` names. |
+| `expired_token` | 3 | retry | none | The sign-in code expired before it was approved. Run databay login again. |
+| `feature_disabled` | 1 | ask_human | none | This feature is off for you or on this server; `details` names it and why. Ask whoever runs the server. |
+| `internal_error` | 8 | ask_human | unknown | The CLI failed unexpectedly. Report it with the crash log it names. |
+| `interrupted` | 1 | ask_human | unknown | Stopped after the request was sent: check its result before running it again. A create is safe to repeat only with the --idempotency-key it printed. |
+| `keyring_unavailable` | 3 | fix_and_retry | none | No usable OS keyring. Pass --token-store file to keep tokens in a 0600 file under the config dir. |
+| `login_failed` | 3 | ask_human | none | Keycloak refused the sign-in; the message names its OAuth error. |
+| `login_required` | 3 | do_first | none | Sign in again with the command `next` names, then run this command again. |
+| `login_timeout` | 3 | retry | none | The browser did not come back in time. Run databay login again, or pass --device. |
+| `network_error` | 6 | retry | unknown | Check the server URL and the network, then run it again. |
+| `no_active_project` | 2 | fix_and_retry | none | Pass --project <project_id>, or set active_project in the profile. |
+| `no_profile` | 3 | do_first | none | Sign in with databay login --server URL, or pass --profile NAME. |
+| `non_databay_answer` | 1 | fix_and_retry | none | Something other than Databay answered (a proxy, a gateway or a wrong server URL): check the profile's server. |
+| `not_ready` | 9 | fix_and_retry | none | Fix what the answer names, then run the check again. |
+| `offline_access_not_granted` | 3 | ask_human | none | Keycloak did not grant offline_access: ask whoever runs the server to give your user that role (docs/cli.md, Sign in). |
+| `org_choice_required` | 2 | fix_and_retry | partial | You are signed in, but you belong to several organizations and none is active. Run databay org switch <organization>, or sign in again with --org. |
+| `org_not_in_token` | 1 | ask_human | complete | The server stored the organization, but the new token names another one. Run databay status; if it persists, ask whoever runs the server. |
+| `profile_invalid` | 3 | fix_and_retry | none | Fix config.toml as the message says. |
+| `project_conflict` | 2 | fix_and_retry | none | Send one project: X-Databay-Project-ID must match the route and the body. |
+| `response_invalid` | 8 | ask_human | unknown | The answer does not match this CLI's models. Upgrade the CLI or report it. |
+| `revoke_failed` | 1 | ask_human | partial | The local credential is deleted, but Keycloak may still hold the session: ask whoever runs the server to revoke it (docs/cli.md, Sign out). |
+| `secret_required` | 2 | fix_and_retry | none | Pass the secret with --<field>-env NAME or --<field>-stdin; it is never a flag. |
+| `server_too_old` | 7 | ask_human | none | This command needs a newer server. Upgrade the server or use an older CLI. |
+| `server_unavailable` | 6 | retry | unknown | The server answered without a Databay error body. Try again later. |
+| `server_version_mismatch` | 7 | ask_human | none | The CLI and the server speak different API majors. Upgrade the older side. |
+| `skill_exists` | 2 | ask_human | none | A skill from another CLI version is installed there. Pass --force to replace it with this version's. |
+| `skill_write_failed` | 2 | ask_human | none | Nothing changed. Make the folder the message names writable, or install with the other --scope. |
+| `stopped` | 1 | retry | none | Stopped while only reading; nothing changed. Run it again, or run `next` to resume a wait. |
+| `token_file_insecure` | 3 | fix_and_retry | none | Run chmod 600 on the file the message names; it holds tokens. |
+| `token_missing` | 3 | do_first | none | Set DATABAY_TOKEN to an access token; the profile reads it from there. |
+| `token_source_conflict` | 2 | fix_and_retry | none | Unset DATABAY_TOKEN, or pass --profile with a profile whose auth is env; the CLI never picks one for you. |
+| `uncoded_error` | 8 | ask_human | unknown | The server answered an error without a code. Report it with the request id. |
+| `unexpected_wait_state` | 5 | ask_human | complete | The server reported a state this CLI does not know. Upgrade the CLI. |
+| `unknown_error_code` | 8 | ask_human | unknown | The server answered a code this CLI does not know. Upgrade the CLI. |
+| `unsupported_platform` | 2 | ask_human | none | Run databay on Linux or macOS; on Windows, use WSL. |
+| `unsupported_product` | 7 | ask_human | none | This server runs Databay for Shopify, which the CLI does not support. |
+| `unsupported_target` | 2 | fix_and_retry | none | Pass --target claude or --target codex; no other agent has a verified skill format. |
+| `usage_invalid` | 2 | fix_and_retry | none | Read the command's --help and pass the flags it names. |
+| `wait_failed` | 5 | ask_human | complete | The operation ran and ended in a failure state; read the error it reports. |
+| `wait_feature_disabled` | 5 | ask_human | unknown | What the wait polled is behind a feature that is off, so it cannot tell how the operation ended. Ask whoever runs the server, then check the result before running a write again. |
+| `wait_pending` | 4 | retry | complete | Run `next`: it resumes the same wait and starts nothing again. |
+| `wait_target_gone` | 5 | ask_human | unknown | What the wait polled no longer exists; it was deleted while waiting. |
+
+## Server codes
+
+| Code | Exit | Action | Side effects | Max retries | Hint |
+|---|---|---|---|---|---|
+| `access_capability_unsupported` | 1 | fix_and_retry | none |  | Remove the columns or row filter, or pick a warehouse that supports them. |
+| `access_check_unavailable` | 6 | retry | none | 3 | Access could not be checked; retry in a moment. |
+| `access_management_unsupported` | 1 | fix_and_retry | none |  | Pick a warehouse whose type supports access roles and logins. |
+| `access_pending` | 6 | retry | none | 5 | Try again in a moment; your warehouse access is still being set up. |
+| `access_role_name_taken` | 1 | fix_and_retry | none |  | Pick another name for the access role. |
+| `access_role_revision_conflict` | 1 | fix_and_retry | none |  | Reload the access settings, then make the change again. |
+| `account_already_a_source` | 1 | fix_and_retry | none |  | Use the source that already reads this account, or choose another account. |
+| `account_choice_required` | 1 | fix_and_retry | none |  | Name one of the accounts detail lists. |
+| `account_lookup_failed` | 1 | fix_and_retry | none |  | Check the credentials, then try again. |
+| `account_not_in_grant` | 1 | fix_and_retry | none |  | Pick an account the credentials reach. |
+| `activation_unavailable` | 6 | retry | unknown | 3 | Retry the activation; contact support if it keeps failing. |
+| `active_org_not_stored` | 1 | ask_human | none |  | Contact support; your organization choice could not be saved. |
+| `actor_required` | 1 | fix_and_retry | none |  | Name an acting user who belongs to an organization. |
+| `ai_busy_today` | 1 | do_first | none |  | Try again after resets_at, or write the query in the SQL editor. |
+| `ai_daily_limit` | 1 | do_first | none |  | Wait until resets_at, or contact us for more questions. |
+| `ai_plan_unknown` | 1 | ask_human | none |  | Contact support; the AI assistant cannot read your plan. |
+| `ai_quota_unavailable` | 6 | retry | none | 3 | Try again shortly. |
+| `alert_instance_not_found` | 1 | fix_and_retry | none |  | List the alerts and pick one you can see. |
+| `allowed_hosts_invalid` | 1 | fix_and_retry | none |  | List IP addresses or networks, or leave allowed hosts empty for any host. |
+| `already_connected` | 1 | fix_and_retry | none |  | Use the connected source; this type allows one per organization. |
+| `already_member` | 1 | fix_and_retry | none |  | Change their role instead. |
+| `already_org_shared` | 1 | fix_and_retry | none |  | Skip the share; the resource is already available in every project of the organization. |
+| `ambiguous_org` | 1 | do_first | none |  | Sign in again; if this persists, an operator must remove the extra organization. |
+| `ambiguous_warehouse` | 1 | fix_and_retry | none |  | Name one of the listed warehouses and ask again. |
+| `announcement_not_found` | 1 | fix_and_retry | none |  | Check the announcement uuid. |
+| `api_key_last_project` | 1 | do_first | none |  | Add another project first, or revoke the key. |
+| `api_key_membership_refused` | 1 | ask_human | unknown |  | Contact support; the key's project access could not be set up. |
+| `api_key_not_allowed` | 1 | ask_human | none |  | Call this route signed in as a person; an API key reaches only routes limited to its projects. |
+| `api_key_not_found` | 1 | fix_and_retry | none |  | List the organization's API keys and pick one of them. |
+| `api_key_project_limit` | 1 | do_first | none |  | Remove a project from the key first, or create another key. |
+| `api_key_project_not_found` | 1 | fix_and_retry | none |  | Name a project the key already has access to. |
+| `api_key_project_refused` | 1 | fix_and_retry | none |  | Name projects of your organization that you administer. |
+| `api_key_replay_unavailable` | 1 | do_first | none |  | Rotate the key to get a new secret. |
+| `api_key_revoked` | 1 | do_first | none |  | Create a new key. |
+| `attach_unsupported_source` | 1 | fix_and_retry | none |  | Create the pipe without reader_id; it then gets a reader of its own. |
+| `auth_unavailable` | 6 | retry | unknown | 3 | Retry after the Retry-After interval. |
+| `backfill_already_running` | 1 | do_first | none |  | Wait for the running backfill named by run_uuid to finish, then start another. |
+| `backfill_filter_rejected` | 1 | fix_and_retry | none |  | Rewrite the row filter without the token detail names. |
+| `backfill_option_unsupported` | 1 | fix_and_retry | none |  | Send the backfill without the field, start date or snapshot mode this pipe cannot honour. |
+| `backfill_trigger_failed` | 1 | fix_and_retry | unknown |  | Fix what the reason in detail names, then start the backfill again. |
+| `backfill_unsupported` | 1 | fix_and_retry | none |  | Leave out the backfill; this source type has none on demand, and streaming continues normally. |
+| `baseline_not_applicable` | 1 | fix_and_retry | none |  | Skip the first definition; this destination cannot report it. |
+| `baseline_table_missing` | 1 | do_first | none |  | Wait until the pipe creates its table, then try again. |
+| `baseline_unavailable` | 6 | retry | none | 3 | Retry in a moment. |
+| `being_removed` | 6 | retry | none | 3 | Retry in a few minutes; the account is still being removed. |
+| `binding_not_found` | 1 | fix_and_retry | none |  | List the resource's bindings and pick one of them. |
+| `binding_pending` | 6 | retry | none | 5 | Retry in a few seconds; a resource that cannot be placed is listed under Needs a home. |
+| `binding_removing` | 6 | retry | none | 3 | Retry after the Retry-After interval. |
+| `board_not_found` | 1 | fix_and_retry | none |  | List the dashboards and pick one you can see. |
+| `budget_below_usage` | 1 | fix_and_retry | none |  | Confirm to pause the project, or set a budget at or above current. |
+| `built_table_restricted_upstream` | 1 | fix_and_retry | none |  | Let the role read the upstream table in full, or grant it the upstream table instead of the built one. |
+| `builtin_not_found` | 1 | fix_and_retry | none |  | Pick a built-in dashboard from the list. |
+| `card_already_on_board` | 1 | fix_and_retry | none |  | The card is already on this dashboard; nothing to add. |
+| `card_not_found` | 1 | fix_and_retry | none |  | Pick a card key the dashboard has. |
+| `card_revision_conflict` | 1 | do_first | none |  | Reload the card to get its current revision, reapply your change, then save again. |
+| `catalogue_unavailable` | 6 | retry | none | 3 | Try again in a moment. |
+| `change_event_not_found` | 1 | fix_and_retry | none |  | List the pipe's schema changes and pick one you can see. |
+| `clickhouse_admin_refused` | 1 | ask_human | none |  | Ask your Databay administrator to check the analytics server's admin account. |
+| `clickhouse_unavailable` | 6 | retry | none | 3 | Retry after the Retry-After interval. |
+| `client_config_unavailable` | 1 | ask_human | none |  | Ask the operator to configure the browser sign-in address on the auth service. |
+| `column_decision_stale` | 1 | fix_and_retry | none |  | Reload the pipe's schema changes and decide on the column as it is listed now. |
+| `column_decision_unavailable` | 6 | retry | unknown | 3 | Retry in a moment; repeating the same decision is safe. |
+| `column_not_granted` | 1 | fix_and_retry | none |  | Leave out the columns listed in columns, or ask an admin to grant them. |
+| `columns_not_in_source` | 1 | fix_and_retry | none |  | Choose from the source table's current columns. |
+| `columns_on_schemaless_stream` | 1 | fix_and_retry | none |  | Send the request without a column selection for this stream. |
+| `completeness_rule_exists` | 1 | fix_and_retry | none |  | Update the pipe's existing completeness rule instead. |
+| `completeness_rule_invalid` | 1 | fix_and_retry | none |  | Fix the temporal settings detail names. |
+| `completeness_rule_not_found` | 1 | fix_and_retry | none |  | List the pipe's completeness rules and pick one of them. |
+| `compliance_export_not_ready` | 1 | do_first | none |  | Wait until the export is ready, then try again. |
+| `compliance_request_not_found` | 1 | fix_and_retry | none |  | Check the compliance request id. |
+| `config_rejected` | 1 | fix_and_retry | none |  | Review the pipe's source, destination and replication key, then create it again. |
+| `configstore_timeout` | 6 | retry | unknown | 3 | Retry in a moment. |
+| `configstore_unavailable` | 6 | retry | none | 3 | Retry in a moment. |
+| `conflicting_table_rules` | 1 | fix_and_retry | none |  | Give the named roles the same columns or the same row filter on the table. |
+| `connector_missing` | 1 | do_first | none |  | Connect the source named in connector and wait for its first data. |
+| `console_answer_invalid` | 1 | ask_human | none |  | Contact support with the request id. |
+| `console_not_scoped` | 1 | ask_human | none |  | Contact support, or whoever runs your Databay server, to turn project scoping on for the SQL console. |
+| `console_unavailable` | 6 | retry | none | 3 | Retry after the Retry-After interval. |
+| `continuation_invalid` | 1 | ask_human | none |  | Connect again. |
+| `continuation_org_mismatch` | 1 | ask_human | none |  | Connect again while signed in to the right organization. |
+| `conversation_not_found` | 1 | fix_and_retry | none |  | Pick one of your own conversations, or start a new one. |
+| `counts_unknown` | 6 | retry | none | 3 | Retry once every service answers. |
+| `credential_already_issued` | 1 | do_first | complete |  | Rotate the login to get a new password. |
+| `credential_key_not_allowed` | 1 | fix_and_retry | none |  | Send only the credential keys this source type accepts. |
+| `credential_value_blank` | 1 | fix_and_retry | none |  | Fill in every credential value. |
+| `credential_warehouse_not_granted` | 1 | fix_and_retry | none |  | Pick a warehouse one of your access roles reads, or ask a project admin for a role that reads it. |
+| `credentials_invalid` | 1 | fix_and_retry | none |  | Fix the credential fields detail names. |
+| `credentials_renewed_elsewhere` | 1 | fix_and_retry | none |  | Renew this source's credentials through its own reconnect flow. |
+| `cross_org` | 1 | fix_and_retry | none |  | Pick a project of your own organization. |
+| `cross_warehouse_reference` | 1 | fix_and_retry | none |  | Drop the database name before the table. |
+| `currency_codes_changed` | 6 | retry | none | 2 | Run the card again in a moment. |
+| `currency_unreadable` | 1 | ask_human | none |  | This data's currencies can't be read; contact support. |
+| `current_version` | 1 | fix_and_retry | none |  | Pick a version that is not current, or confirm retiring the current one. |
+| `custom_plan_delivery_failed` | 6 | retry | none | 2 | Retry, or email us. |
+| `custom_plan_request_too_soon` | 6 | retry | none | 1 | Retry after the Retry-After interval. |
+| `dashboard_query_failed` | 6 | retry | none | 2 | Retry; contact support if it keeps failing. |
+| `database_connection_failed` | 1 | fix_and_retry | none |  | Check the host, port, credentials and firewall rules for the failure detail names, then try again. |
+| `database_health_check_failed` | 1 | ask_human | none |  | Ask the database's administrator to check its health, then try again. |
+| `dataset_unavailable` | 1 | ask_human | none |  | Contact support; the dataset's tables are in a shape no dataset reads. |
+| `dataset_version_retired` | 1 | fix_and_retry | none |  | Update the card to current_version. |
+| `delete_blocked` | 1 | fix_and_retry | none |  | Pick another target project, or first move what the answer's hint names. |
+| `dest_schema_rejected` | 1 | fix_and_retry | none |  | Point the pipe at a new destination table, or drop the existing table if you no longer need its data. |
+| `dest_unreachable` | 6 | retry | none | 3 | Retry; if it keeps failing, check the destination warehouse's connection details. |
+| `destination_check_refused` | 1 | fix_and_retry | none |  | Fix the warehouse's connection settings or its user's access as detail says, then retry. |
+| `destination_table_exists` | 1 | fix_and_retry | none |  | Pick another destination table, or change the transformation that already writes it. |
+| `destination_table_incompatible` | 1 | fix_and_retry | none |  | Pick another destination table name, or drop the existing table, then retry. |
+| `destination_table_taken` | 1 | fix_and_retry | none |  | Pick another destination table. |
+| `disable_reason_too_long` | 1 | fix_and_retry | none |  | Shorten the reason. |
+| `docs_article_moved` | 1 | fix_and_retry | none |  | Follow Location to the article's current slug. |
+| `docs_article_not_found` | 1 | fix_and_retry | none |  | Check the article slug. |
+| `docs_authoring_disabled` | 1 | ask_human | none |  | Ask an operator to turn on documentation authoring. |
+| `docs_body_too_large` | 1 | fix_and_retry | none |  | Shorten the article body. |
+| `docs_engine_internals_leaked` | 1 | fix_and_retry | none |  | Remove the engine internals from the article. |
+| `docs_plugin_invalid` | 1 | fix_and_retry | none |  | Pick a known plugin, or leave it out. |
+| `docs_section_invalid` | 1 | fix_and_retry | none |  | Pick a known section. |
+| `docs_slug_invalid` | 1 | fix_and_retry | none |  | Send a valid slug. |
+| `docs_slug_reserved` | 1 | fix_and_retry | none |  | Pick another slug. |
+| `docs_slug_taken` | 1 | fix_and_retry | none |  | Pick another slug. |
+| `docs_unavailable` | 6 | retry | none | 3 | Retry in a moment. |
+| `draft_already_published` | 1 | do_first | none |  | Create a new draft from the published version. |
+| `draft_changed` | 1 | fix_and_retry | none |  | Reload the draft metric model and make your change again. |
+| `draft_exists` | 1 | fix_and_retry | none |  | Edit the existing draft, or replace it. |
+| `draft_render_missing` | 1 | fix_and_retry | none |  | Run the preview again. |
+| `effective_not_lowering` | 1 | fix_and_retry | none |  | Send the change without an effective date; it applies now. |
+| `elt_unavailable` | 6 | retry | none | 3 | The models could not be listed; retry in a moment. |
+| `email_not_verified` | 1 | ask_human | none |  | Open the link we emailed you, or send a new one from the sign-in page. |
+| `endpoint_removed` | 1 | fix_and_retry | none |  | Call the replacement route detail names. |
+| `entitlements_unavailable` | 6 | retry | none | 3 | Retry after the Retry-After interval. |
+| `exists` | 1 | fix_and_retry | none |  | Renew the connected account's credentials instead. |
+| `external_plan` | 1 | ask_human | none |  | Change the plan in the Shopify app; this meter takes no override. |
+| `external_warehouses_unsupported` | 1 | ask_human | none |  | Use the managed warehouse; pipelines land there without a destination to register. |
+| `extra_is_primary` | 1 | fix_and_retry | none |  | Leave the primary property out of the extra properties. |
+| `feature_not_in_plan` | 1 | ask_human | none |  | Ask an organization admin to move to a plan that includes this feature. |
+| `feature_not_rollout` | 1 | fix_and_retry | none |  | Pick a rollout feature; only those can be set per organization. |
+| `file_check_busy` | 6 | retry | none | 3 | Retry after the Retry-After interval. |
+| `file_check_timeout` | 1 | fix_and_retry | none |  | Upload a smaller file, or save the workbook's data as CSV. |
+| `file_columns_limit_reached` | 1 | fix_and_retry | none |  | Remove columns from the named tab so it stays within the limit. |
+| `file_encoding_unsupported` | 1 | fix_and_retry | none |  | Pick the file's encoding in the file settings, or save it as UTF-8. |
+| `file_header_invalid` | 1 | fix_and_retry | none |  | Give every column of the named tab a unique name in its header row, or set that tab's header row. |
+| `file_not_uploaded` | 1 | do_first | none |  | Upload a file to the source first. |
+| `file_shared_strings_too_large` | 1 | fix_and_retry | none |  | Save the workbook's data as CSV and upload that instead. |
+| `file_stage_expired` | 1 | do_first | none |  | Upload the file again to check it. |
+| `file_stage_superseded` | 1 | ask_human | none |  | Review the source's current file, then upload yours again if it should replace it. |
+| `file_too_large` | 1 | fix_and_retry | none |  | Upload a smaller file, or split it into several files. |
+| `file_type_unsupported` | 1 | fix_and_retry | none |  | Save the file as .csv, .tsv or .xlsx and upload it again. |
+| `file_unavailable` | 1 | do_first | none |  | Upload the file to the source again. |
+| `file_uncompressed_too_large` | 1 | fix_and_retry | none |  | Remove unused sheets or rows from the workbook, or save the data as CSV. |
+| `file_unreadable` | 1 | fix_and_retry | none |  | Open the file, save it again as .csv or .xlsx, and upload the new copy. |
+| `file_upload_needs_acknowledgement` | 1 | ask_human | none |  | Review the listed warnings and confirm again, acknowledging each one. |
+| `filter_type_conflict` | 1 | fix_and_retry | none |  | Rename the filter, keep its kind, or take the card off this dashboard. |
+| `folder_cycle` | 1 | fix_and_retry | none |  | Move the folder somewhere outside itself. |
+| `folder_name_taken` | 1 | fix_and_retry | none |  | Pick another folder name. |
+| `folder_not_empty` | 1 | do_first | none |  | Move or delete the folder's folders and dashboards first. |
+| `folder_not_found` | 1 | fix_and_retry | none |  | List the folders and pick one you can see. |
+| `folder_not_in_project` | 1 | fix_and_retry | none |  | Pick a folder of this project. |
+| `folder_too_deep` | 1 | fix_and_retry | none |  | Place the folder higher up; folders nest at most limit levels deep. |
+| `free_order_cap` | 1 | ask_human | none |  | Contact us for a plan with a higher order limit. |
+| `fx_rate_missing` | 1 | fix_and_retry | none |  | Pick a range or a reporting currency that has exchange rates. |
+| `fx_rate_unavailable` | 1 | fix_and_retry | none |  | Pick a reporting currency that has exchange rates for the currencies listed. |
+| `fx_unavailable` | 6 | retry | none | 3 | Try again in a moment. |
+| `git_auth_failed` | 1 | do_first | none |  | Add the deploy key to the repository read-only, or use a token that can read it. |
+| `git_commit_rejected` | 1 | fix_and_retry | none |  | Fix the file and line named, then push a new commit. |
+| `git_connection_busy` | 6 | retry | none | 3 | Retry in a moment; the git connection changed meanwhile. |
+| `git_connection_exists` | 1 | do_first | none |  | Disconnect the project's repository first, then connect again. |
+| `git_host_key_changed` | 1 | ask_human | none |  | Check the repository host's key; if the change is expected, connect the repository again. |
+| `git_installation_not_yours` | 1 | do_first | none |  | Install the Databay GitHub App from Databay's own install link, then connect again. |
+| `git_not_connected` | 1 | do_first | none |  | Connect a repository to the project first. |
+| `git_ref_not_found` | 1 | fix_and_retry | none |  | Name a branch and folder that exist in the repository. |
+| `git_repo_not_installed` | 1 | do_first | none |  | Install the Databay GitHub App on the repository, then connect again. |
+| `git_repo_too_large` | 1 | fix_and_retry | none |  | Make the dbt folder smaller, or keep large files out of it. |
+| `git_sync_failed` | 6 | retry | none | 3 | Retry the sync; if it keeps failing, tell support. |
+| `git_unreachable` | 6 | retry | none | 3 | Retry in a moment; the repository's host did not answer. |
+| `github_app_not_configured` | 1 | fix_and_retry | none |  | Connect with a deploy key or a token; this server has no GitHub App. |
+| `github_app_permission_refused` | 1 | do_first | none |  | Grant the Databay GitHub App the permissions Databay lists, then retry. |
+| `github_unavailable` | 6 | retry | none | 3 | Retry in a moment; GitHub did not answer. |
+| `home_board_not_deletable` | 1 | do_first | none |  | Set another dashboard as the project's Overview, then delete this one. |
+| `home_conflict` | 1 | fix_and_retry | none |  | Share the resource into the project instead; it already has a home project. |
+| `host_not_allowed` | 1 | fix_and_retry | none |  | Use your database's own address, a public hostname or a private address in your network. |
+| `idempotency_key_required` | 1 | fix_and_retry | none |  | Send the apply again with an Idempotency-Key header. |
+| `idempotency_key_reused` | 1 | fix_and_retry | none |  | Send a new Idempotency-Key for a new request. |
+| `immutable_source_field` | 1 | fix_and_retry | none |  | Create a new source to change the fields listed. |
+| `import_conflict` | 1 | fix_and_retry | none |  | Choose which side wins for the conflicting overrides, then import again. |
+| `instance_name_taken` | 1 | fix_and_retry | none |  | Pick another name. |
+| `internal_sink_not_found` | 1 | do_first | none |  | Wait for the organization's managed warehouse to be set up; contact support if it does not appear. |
+| `invalid_account_id` | 1 | fix_and_retry | none |  | Send a valid account id for the platform. |
+| `invalid_actor` | 1 | fix_and_retry | none |  | Send a valid operator name as actor. |
+| `invalid_card_sql` | 1 | fix_and_retry | none |  | Fix the card's SQL. |
+| `invalid_cron_expression` | 1 | fix_and_retry | none |  | Send a valid cron expression. |
+| `invalid_expiry` | 1 | fix_and_retry | none |  | Send an ISO-8601 UTC time in the future. |
+| `invalid_filter_value` | 1 | fix_and_retry | none |  | Fix the value of the filter named in filter. |
+| `invalid_filters` | 1 | fix_and_retry | none |  | Fix the dashboard filters as reason says. |
+| `invalid_layout` | 1 | fix_and_retry | none |  | Fix the card layout as reason says. |
+| `invalid_limit` | 1 | fix_and_retry | none |  | Send a limit that is valid for the meter. |
+| `invalid_param` | 1 | fix_and_retry | none |  | Fix the bound parameter named in param. |
+| `invalid_plan_ref` | 1 | fix_and_retry | none |  | Name the plan as <plan> or <plan>@<version>. |
+| `invalid_price` | 1 | fix_and_retry | none |  | Send a valid price with its currency and period. |
+| `invalid_spec` | 1 | fix_and_retry | none |  | Fix the card named by key as reason says. |
+| `invalid_tenant_identifier` | 1 | ask_human | none |  | Contact support; the organization's name cannot be mapped to a warehouse database. |
+| `invalid_version` | 1 | fix_and_retry | none |  | Fix the problems listed, then try again. |
+| `invitation_already_open` | 1 | fix_and_retry | none |  | Invite them with the open invitation's role and language, or ask an org admin to revoke it. |
+| `invitation_email_mismatch` | 1 | do_first | none |  | Sign in with the email address the invitation was sent to. |
+| `invitation_inviter_not_admin` | 1 | ask_human | partial |  | Ask an admin of the organization for a new invitation. |
+| `invitation_link_unavailable` | 1 | ask_human | none |  | Ask the server's operator to set the public app URL and secret key. |
+| `invitation_not_found` | 1 | fix_and_retry | none |  | Reload the list of invitations and pick one that is still there. |
+| `invitation_not_valid` | 1 | ask_human | none |  | Ask the person who invited you for a new invitation. |
+| `invitation_rate_limited` | 6 | retry | none | 3 | Wait for the Retry-After interval, then open the link again. |
+| `invitation_single_org` | 1 | ask_human | none |  | Contact support to join another organization. |
+| `job_name_exists` | 1 | fix_and_retry | none |  | Pick another name for the transformation. |
+| `job_name_taken` | 1 | fix_and_retry | none |  | Pick another name; transformation names are unique in the organization. |
+| `job_not_found` | 1 | fix_and_retry | none |  | List the transformations and pick one you can see. |
+| `keyless_selection_needs_key` | 1 | fix_and_retry | none |  | Name a primary_key for the selection on this keyless table. |
+| `landed_tables_unreadable` | 1 | fix_and_retry | none |  | Fix the warehouse's connection settings or its user's access as detail says, then retry. |
+| `last_admin` | 1 | do_first | none |  | Make another member an admin first. |
+| `leftover_check_unavailable` | 6 | retry | none | 3 | Check that the database is reachable, then check again. |
+| `leftover_not_found` | 1 | fix_and_retry | none |  | Reload the list; this leftover is already resolved or is not in your project. |
+| `leftover_source_gone` | 1 | ask_human | none |  | Drop it on the database yourself with the SQL shown, then dismiss it. |
+| `lineage_unreadable` | 1 | ask_human | none |  | Ask your Databay administrator to check the warehouse's query log. |
+| `lineage_window_too_large` | 1 | fix_and_retry | none |  | Read the lineage in shorter windows. |
+| `login_validity_invalid` | 1 | fix_and_retry | none |  | Pick an expiry date in the future and within the allowed number of days. |
+| `logout_failed` | 6 | retry | unknown | 3 | Retry signing out. |
+| `managed_warehouse_sink_locked` | 1 | fix_and_retry | none |  | Send the request again without sink_db_uuid. |
+| `manifest_stale` | 1 | do_first | none |  | Run the delete preview again and confirm the new manifest. |
+| `mask_columns_not_selected` | 1 | fix_and_retry | none |  | Mask only columns the selection includes, or add the columns listed in columns to the selection. |
+| `member_access_unchanged` | 1 | fix_and_retry | none |  | Reload the member's status; the change you asked for is already in place. |
+| `member_is_api_key` | 1 | fix_and_retry | none |  | Manage it with the API key routes (databay api-key), or revoke the key. |
+| `member_lookup_unavailable` | 6 | retry | none | 3 | Retry after the Retry-After interval. |
+| `member_not_api_key` | 1 | fix_and_retry | none |  | Manage this member with the project member routes; only API keys are managed here. |
+| `member_not_found` | 1 | fix_and_retry | none |  | List the organization's members and pick one of them. |
+| `member_not_in_organization` | 1 | do_first | none |  | Invite them to the organization first. |
+| `member_role_unchanged` | 1 | fix_and_retry | none |  | Pick a role the member does not hold yet. |
+| `metric_card_invalid` | 1 | fix_and_retry | none |  | Edit the card to use the metric's own dimensions. |
+| `metric_cards_unavailable` | 1 | fix_and_retry | none |  | Save the card with a SQL query instead of a metric. |
+| `metric_needs_yaml` | 1 | fix_and_retry | none |  | Edit this metric in the model's YAML and push the model. |
+| `metric_not_found` | 1 | fix_and_retry | none |  | List the metrics you can query and use one of their names. |
+| `metric_not_granted` | 1 | ask_human | none |  | Ask an admin for a warehouse access role that includes this metric. |
+| `metric_query_failed` | 6 | retry | none | 3 | The metric query failed; retry in a moment. |
+| `migration_refused` | 1 | fix_and_retry | none |  | Fix each organization listed in refused, or leave it out, then run the move again. |
+| `missing_feature_values` | 1 | fix_and_retry | none |  | Set a value for each feature listed in problems. |
+| `missing_meter_values` | 1 | fix_and_retry | none |  | Set a value for each meter listed in problems. |
+| `missing_param` | 1 | fix_and_retry | none |  | Bind the parameter to a filter, or give it a fixed value. |
+| `missing_sources` | 1 | do_first | none |  | Connect the sources listed in missing. |
+| `model_check_unavailable` | 6 | retry | none | 3 | Retry in a moment; nothing was saved. |
+| `model_in_git` | 1 | ask_human | none |  | Edit this model in its repository; Databay syncs the change. |
+| `model_in_use` | 1 | fix_and_retry | none |  | Change or delete the models listed in readers first, then delete this one. |
+| `model_managed_in_git` | 1 | fix_and_retry | none |  | Edit the semantic files in the project's git repository instead. |
+| `model_name_reserved` | 1 | fix_and_retry | none |  | Pick a name without the reserved part. |
+| `model_name_taken` | 1 | fix_and_retry | none |  | Pick another name for the model. |
+| `model_not_published` | 1 | do_first | none |  | Publish the project's draft metric model, then query again. |
+| `model_refresh_unsupported` | 1 | fix_and_retry | none |  | Store the model as a table or incremental table, or set its refresh to manual. |
+| `model_rejected` | 1 | fix_and_retry | none |  | Fix each listed field of the model and upload it again. |
+| `model_sources_unavailable` | 6 | retry | none | 3 | Retry in a moment. |
+| `model_sql_rejected` | 1 | fix_and_retry | none |  | Change the model's SQL as detail says, then save again. |
+| `model_version_stale` | 1 | fix_and_retry | none |  | Open the current version, apply your edits to it, then save again. |
+| `model_version_unavailable` | 6 | retry | none | 3 | The metric model is updating; retry in a moment. |
+| `model_warehouse_unusable` | 1 | do_first | none |  | Pick a warehouse this project uses and that is ready, then save again. |
+| `multi_property_off` | 1 | fix_and_retry | none |  | Connect one property per connection. |
+| `name_collision` | 1 | ask_human | none |  | Contact support; the warehouse's analytics server name belongs to another warehouse. |
+| `name_reserved` | 1 | fix_and_retry | none |  | Pick another warehouse name. |
+| `name_taken` | 1 | fix_and_retry | none |  | Pick another warehouse name. |
+| `new_columns_unsupported` | 1 | fix_and_retry | none |  | Use add for new columns; asking first is not available for this pipe or organization. |
+| `no_draft` | 1 | do_first | none |  | Create a draft of the plan first. |
+| `no_published_version` | 1 | do_first | none |  | Publish the plan's draft first. |
+| `no_reachable_account` | 1 | fix_and_retry | none |  | Check that the token reaches at least one account. |
+| `no_subscription` | 1 | ask_human | none |  | Ask an operator to assign the organization a plan with the command fix names. |
+| `no_tenant_data` | 1 | do_first | none |  | Connect a source, or preview with sample data. |
+| `no_warehouse_access` | 1 | ask_human | none |  | Ask a project admin for access to the dashboard's warehouse. |
+| `not_blocking` | 1 | fix_and_retry | none |  | Name only checks that block the source. |
+| `not_checked` | 1 | do_first | none |  | Check the source first. |
+| `not_dlt` | 1 | fix_and_retry | none |  | Pick a source type this deployment syncs. |
+| `not_home` | 1 | ask_human | none |  | Open the project that manages it, or ask its editors. |
+| `not_retryable` | 1 | fix_and_retry | none |  | Read status; only a failed warehouse can be retried. |
+| `notice_missing` | 1 | fix_and_retry | none |  | Send a notice with the change that lowers the limit. |
+| `notice_window` | 1 | fix_and_retry | none |  | Schedule the change for earliest or later. |
+| `notification_not_found` | 1 | fix_and_retry | none |  | Find the id with the notification log script, then run the replay again. |
+| `notification_params_purged` | 1 | ask_human | none |  | Ask the producer for a new notification, since this one can no longer be rendered. |
+| `notification_replay_expired` | 1 | fix_and_retry | none |  | Run the replay again with a future --not-after. |
+| `notification_replay_no_address` | 1 | ask_human | none |  | Fix the recipient's contact, then run the replay again. |
+| `notification_replay_not_eligible` | 1 | fix_and_retry | none |  | Pick a row in a status replay takes; a sent row needs --include-sent. |
+| `numbers_updating` | 6 | retry | none | 3 | The numbers are still being built; retry in a moment. |
+| `oauth_access_denied` | 1 | fix_and_retry | none |  | Sign in again and allow Databay access on the provider's screen. |
+| `oauth_callback_invalid` | 1 | ask_human | none |  | Start connecting again. |
+| `oauth_exchange_failed` | 1 | ask_human | none |  | Connect again. |
+| `oauth_not_configured` | 1 | ask_human | none |  | Ask an operator to set up the provider's OAuth app, or connect with your own credentials. |
+| `oauth_scopes_missing` | 1 | fix_and_retry | none |  | Sign in again and leave every permission ticked. |
+| `oauth_source_field_not_editable` | 1 | fix_and_retry | none |  | Edit only the name, and reconnect the source to renew its credentials. |
+| `oauth_state_invalid` | 1 | ask_human | none |  | Start connecting again. |
+| `operator_preview_stale` | 1 | fix_and_retry | none |  | Preview the change again and confirm the new preview. |
+| `operator_request_not_received` | 1 | ask_human | none |  | Treat the change as not applied, and apply it again with a new key if it is still wanted. |
+| `operator_work_failed` | 1 | ask_human | unknown |  | Check the target's state before you try the action again. |
+| `operator_work_overdue` | 1 | ask_human | unknown |  | Check the target's state before you try the action again. |
+| `operator_work_started` | 1 | do_first | unknown |  | Check the request under the same key; do not resend it under a new key. |
+| `org_claim_invalid` | 1 | do_first | none |  | Sign in again; if this persists, contact support. |
+| `org_create_daily_limit` | 1 | do_first | none |  | Wait for the Retry-After interval, then create it again. |
+| `org_create_limit` | 1 | ask_human | none |  | The limit for new organizations is reached; ask an admin of an existing one to add you. |
+| `org_create_single_org` | 1 | ask_human | none |  | Contact support to create another organization. |
+| `org_disabled` | 1 | ask_human | none |  | This organization is disabled; pick another one or contact support. |
+| `org_domain_claimed` | 1 | ask_human | partial |  | Ask an admin of the organization that holds your email domain to invite you. |
+| `org_key_conflict` | 6 | retry | none | 1 | Send the request again. |
+| `org_not_found` | 1 | ask_human | none |  | Sign in again; if this persists, contact support. |
+| `org_not_member` | 1 | fix_and_retry | none |  | Pick one of the organizations you belong to. |
+| `org_required` | 1 | do_first | none |  | Create or join an organization in the web app first. |
+| `org_visible_destination` | 1 | fix_and_retry | none |  | Confirm with acknowledge_org_visible=true, or pick a destination of this project. |
+| `organization_required` | 1 | ask_human | none |  | Ask an admin to add you to an organization, then sign in again. |
+| `organization_warehouse_unmapped` | 1 | ask_human | none |  | Contact support; the organization maps to no warehouse database. |
+| `outbox_full` | 6 | retry | none | 3 | Retry in a moment; the service refuses writes while its event queue catches up. |
+| `owner_answer_invalid` | 1 | ask_human | unknown |  | Ask an engineer to check that the staff console and the service run the same release. |
+| `owner_answer_mismatch` | 1 | ask_human | unknown |  | Ask an engineer to compare this request with the service's own audit log. |
+| `owner_unavailable` | 6 | retry | unknown | 3 | Try again in a minute; an apply sent again with the same key never applies twice. |
+| `password_code_attempts_exhausted` | 1 | do_first | none |  | Send a new code, then enter the one in the new email. |
+| `password_code_expired` | 1 | do_first | none |  | Send a new code, then enter the one in the new email. |
+| `password_code_invalid` | 1 | fix_and_retry | partial |  | Check the code in the latest email and enter it again. |
+| `password_code_not_mailable` | 1 | do_first | none |  | Send a new code from the password dialog; this one was replaced or used. |
+| `password_code_resend_too_soon` | 1 | do_first | none |  | Wait for the Retry-After interval, then send a new code. |
+| `password_code_send_limit` | 1 | do_first | none |  | Wait for the Retry-After interval, then send a new code. |
+| `password_email_missing` | 1 | ask_human | none |  | Ask an admin to add an email address to your account. |
+| `password_mail_unavailable` | 6 | retry | none | 3 | Try again in a minute. |
+| `password_policy_refused` | 1 | fix_and_retry | none |  | Choose a password that meets the rule the answer names. |
+| `payg_not_allowed` | 1 | fix_and_retry | none |  | Move the organization to a plan that allows overage, or keep within the limit. |
+| `permission_denied` | 1 | ask_human | none |  | Ask an admin for the role this action needs. |
+| `personal_login_dropping` | 6 | retry | none | 3 | Your previous login for this warehouse is still being removed; try again in a minute. |
+| `personal_login_exists` | 1 | fix_and_retry | none |  | Rotate your existing login for this warehouse to get a new password. |
+| `personal_logins_disabled` | 1 | ask_human | none |  | Ask a project admin to turn on personal logins for this project. |
+| `pipe_already_exists` | 1 | fix_and_retry | none |  | Pick another destination table, or use the pipe named by existing_pipe_uuid. |
+| `pipe_busy` | 6 | retry | none | 3 | Another change to this pipe is running; retry in a few seconds. |
+| `pipe_deleting` | 1 | fix_and_retry | none |  | Create a new pipe if you still need one; this one is being deleted. |
+| `pipe_lookup_failed` | 6 | retry | none | 3 | Retry; the delete waits until the pipelines using it are known. |
+| `pipe_not_failed` | 1 | fix_and_retry | none |  | Release a pipe only once it has failed; resync or pause a running one instead. |
+| `pipe_not_found` | 1 | fix_and_retry | none |  | List the pipes and pick one you can see. |
+| `pipe_not_ready` | 1 | do_first | none |  | Wait until the pipe is active (retry it if it failed), then try again. |
+| `pipe_not_retriable` | 1 | fix_and_retry | none |  | Read current_status; only a failed pipe can be retried. |
+| `pipe_not_scheduled` | 1 | do_first | none |  | Resume the pipe or give it a run schedule first. |
+| `pipe_restart_unsupported` | 1 | do_first | none |  | Wait for the pipe's next scheduled run instead; this engine retries on its own schedule. |
+| `pipe_retry_too_soon` | 6 | retry | none | 1 | Wait retry_after_seconds, then retry the pipe. |
+| `pipe_shares_reader` | 1 | do_first | none |  | Delete or move the other pipes of the reader first. |
+| `pipeline_editor_required` | 1 | ask_human | none |  | Ask for Project Editor on every pipeline that uses the source, or delete those pipelines first. |
+| `pipes_present` | 1 | do_first | none |  | Delete the pipelines that use the warehouse first. |
+| `pipes_unavailable` | 6 | retry | none | 3 | Retry in a moment. |
+| `plan_exists` | 1 | fix_and_retry | none |  | Pick another name, or replace the existing plan. |
+| `plan_file_invalid` | 1 | fix_and_retry | none |  | Fix the problems listed in the plan file. |
+| `plan_seed_invalid` | 1 | ask_human | none |  | Ask an operator to fix the built-in plan seed. |
+| `plan_source_limit` | 1 | ask_human | none |  | Contact us for a plan with more sources. |
+| `platform_credentials_missing` | 1 | fix_and_retry | none |  | Supply your own platform credentials. |
+| `policy_apply_failed` | 1 | ask_human | none |  | The metric model is not updating; ask your org admin to check access. |
+| `precheck_busy` | 6 | retry | none | 3 | Retry after the Retry-After interval. |
+| `precheck_limiter_unavailable` | 6 | retry | none | 3 | Retry after the Retry-After interval. |
+| `precheck_rate_limited` | 6 | retry | none | 3 | Retry after the Retry-After interval. |
+| `preview_expired` | 1 | fix_and_retry | none |  | Preview the change again, then apply it within five minutes. |
+| `preview_mismatch` | 1 | fix_and_retry | none |  | Apply the change exactly as previewed, or preview the new change first. |
+| `preview_not_found` | 1 | fix_and_retry | none |  | Preview the change again and apply the new preview. |
+| `principal_disabled` | 1 | ask_human | none |  | Ask a project admin to enable this login, then rotate it for a new password. |
+| `project_admin_required` | 1 | ask_human | none |  | Ask a project admin to do this, or to make you a project admin. |
+| `project_conflict` | 2 | fix_and_retry | none |  | Send one project: X-Databay-Project-ID must match the route and the body. |
+| `project_forbidden` | 1 | ask_human | none |  | Pick another project or ask a project admin for access. |
+| `project_general_immutable` | 1 | fix_and_retry | none |  | Use another project; General cannot be renamed, deleted, restricted or have its members changed. |
+| `project_live_graph_immutable` | 1 | fix_and_retry | none |  | Leave the items that have live pipelines unchanged, or delete those pipelines first. |
+| `project_member_not_found` | 1 | do_first | none |  | Add them to the project as a member first. |
+| `project_models_broken` | 1 | do_first | none |  | Fix the models listed in broken_models first, then save again. |
+| `project_not_deleting` | 1 | fix_and_retry | none |  | Check the project's state; this call applies only to a project being deleted. |
+| `project_not_empty` | 1 | do_first | none |  | Move or delete its pipelines and resources, or ask an org admin for a forced delete. |
+| `project_not_found` | 1 | fix_and_retry | none |  | Pick a project you can see; this one does not exist, is being deleted, or is not visible to you. |
+| `project_required` | 1 | fix_and_retry | none |  | Send the X-Databay-Project-ID header (databay --project). |
+| `project_revision_conflict` | 1 | do_first | none |  | Reload the canvas to get the current revision, reapply your change, then save again. |
+| `property_id_invalid` | 1 | fix_and_retry | none |  | Send the numeric GA4 property id. |
+| `property_not_readable` | 1 | ask_human | none |  | Grant the key Viewer access on the property, then try again. |
+| `provider_unavailable` | 6 | retry | none | 3 | Retry in a moment. |
+| `publication_mode_locked` | 1 | ask_human | none |  | Keep the current choice, or delete this source's pipelines before changing it. |
+| `publication_mode_not_applicable` | 1 | fix_and_retry | none |  | Leave the publication choice out: only Postgres sources have one. |
+| `publication_mode_unset` | 1 | do_first | none |  | Choose who creates the publication on the source, then create the pipeline. |
+| `publication_mode_unsupported` | 1 | ask_human | none |  | Choose the path where Databay creates the publication, or move to the native engine and Postgres 13. |
+| `publication_modes_off` | 1 | fix_and_retry | none |  | Leave the publication choice out: on this deployment Databay creates the publication. |
+| `publication_state_unavailable` | 6 | retry | none | 3 | Retry after the Retry-After interval. |
+| `qualifier_rewrite_failed` | 1 | fix_and_retry | none |  | Ask again, or write the query in the SQL editor. |
+| `query_rejected` | 1 | fix_and_retry | none |  | Fix the query as detail says. |
+| `query_timeout` | 1 | fix_and_retry | none |  | Narrow the query or add filters so it finishes in time. |
+| `question_failed` | 6 | retry | none | 2 | Ask again, or write the query in the SQL editor. |
+| `quota_exceeded` | 1 | do_first | none |  | Wait until the hourly query limit resets, then try again. |
+| `quota_reached` | 1 | ask_human | none |  | Delete one to make room, or ask whoever lift_by names to raise the limit in quota. |
+| `reader_conflict` | 1 | ask_human | none |  | Ask your Databay administrator to check this warehouse's reader. |
+| `reader_engine_mismatch` | 1 | fix_and_retry | none |  | Create the pipe without reader_id, or switch the reader to this pipe's engine first. |
+| `reader_full` | 1 | fix_and_retry | none |  | Create the pipe without reader_id to give it a reader of its own. |
+| `reader_partition_conflict` | 1 | fix_and_retry | none |  | Create the pipe without reader_id to give it a reader of its own. |
+| `reader_password_missing` | 1 | ask_human | none |  | Ask your Databay administrator to rotate this warehouse's reader. |
+| `reader_publication_mode_mismatch` | 1 | fix_and_retry | none |  | Create the pipe without reader_id; it then gets a reader of its own. |
+| `reader_scope_required` | 1 | fix_and_retry | none |  | Send the request again with "scope": "reader"; the answer lists the pipes it changes. |
+| `reason_required` | 1 | fix_and_retry | none |  | Say why you are making the change, then send it again. |
+| `reason_too_short` | 1 | fix_and_retry | none |  | Say why you are making the change in at least 15 characters. |
+| `rebuild_in_progress` | 1 | do_first | none |  | Wait for the pipe's open rebuild or migration to finish, then try again. |
+| `rebuild_source_invalid` | 1 | fix_and_retry | none |  | Pick a rebuild source this pipe supports. |
+| `reconnect_different_account` | 1 | fix_and_retry | none |  | Pick the source's own account when reconnecting. |
+| `reconnect_different_login` | 1 | fix_and_retry | none |  | Sign in again with the login this source was set up with. |
+| `reconnect_wrong_type` | 1 | fix_and_retry | none |  | Reconnect with a source of the same type. |
+| `removed_setting` | 1 | ask_human | none |  | Ask an operator to remove the setting named in setting from the environment. |
+| `replication_key_outside_identity` | 1 | fix_and_retry | none |  | Choose a replication key within the reader's identity columns, or create the pipe without reader_id. |
+| `reporting_currency_required` | 1 | fix_and_retry | none |  | Set a reporting currency. |
+| `request_invalid` | 1 | fix_and_retry | none |  | Fix the fields the answer names, then send the request again. |
+| `requires_support` | 1 | ask_human | none |  | Contact Databay support to accept this check. |
+| `reset_mail_unavailable` | 1 | ask_human | none |  | Ask an operator to set the realm's mail server, then reset the password again. |
+| `resource_not_found` | 1 | fix_and_retry | none |  | Check the resource id; it is not in your organization. |
+| `resource_not_shared` | 1 | do_first | none |  | Share it into the project from the project that manages it. |
+| `resource_not_visible` | 1 | fix_and_retry | none |  | Check the id and the active project; the resource does not exist or is not visible to you. |
+| `result_too_large` | 1 | fix_and_retry | none |  | Narrow the range or aggregate. |
+| `resync_required` | 1 | do_first | none |  | Resync the pipe with the call named in next; resuming cannot bring back the missing changes. |
+| `retry_cooldown` | 6 | retry | none | 1 | Wait retry_after_s, then retry the warehouse. |
+| `revision_conflict` | 1 | do_first | none |  | Reload the dashboard to get the current revision, reapply your change, then save again. |
+| `rollout_off_cli_only` | 1 | ask_human | none |  | Ask an operator to change it with the operator CLI. |
+| `row_count_unavailable` | 6 | retry | none | 2 | Try again in a moment; until the warehouse answers, the count is unknown. |
+| `row_filter_invalid` | 1 | fix_and_retry | none |  | Fix the filter condition the error names so its column exists and its value fits the column type. |
+| `rule_built_relation_unknown` | 1 | fix_and_retry | none |  | Pick a model from the warehouse's built models. |
+| `rule_column_unknown` | 1 | fix_and_retry | none |  | Pick columns the table has. |
+| `rule_duplicate_table` | 1 | fix_and_retry | none |  | Name each table once per warehouse in an access role. |
+| `rule_overlap` | 1 | fix_and_retry | none |  | Keep either one whole-warehouse rule or table rules for each warehouse in a role. |
+| `rule_scope_invalid` | 1 | fix_and_retry | none |  | Name a table for a rule with columns or a row filter, and switch the role to rules before editing them. |
+| `rule_table_unknown` | 1 | fix_and_retry | none |  | Pick a table the warehouse has. |
+| `rule_warehouse_not_managed` | 1 | fix_and_retry | none |  | Pick a warehouse Databay manages for your organization. |
+| `rule_warehouse_not_visible` | 1 | do_first | none |  | Share the warehouse with this project first, or pick one it can see. |
+| `schema_change_unsupported` | 1 | ask_human | none |  | Change the destination table yourself, or rebuild the pipe's table; it cannot be applied for you. |
+| `schema_query_failed` | 6 | retry | unknown | 2 | Retry; contact support if the change still cannot be written. |
+| `schema_state_stuck_finishing` | 1 | ask_human | none |  | Contact support with the pipe's id; its rebuild finished but the change did not clear. |
+| `schema_state_unavailable` | 6 | retry | none | 3 | Retry in a moment. |
+| `schema_state_unknown_combination` | 1 | ask_human | none |  | Contact support with the pipe's id and the request id. |
+| `schema_version_contention` | 6 | retry | none | 3 | Retry; another apply on the pipe is in progress. |
+| `schema_version_not_found` | 1 | fix_and_retry | none |  | List the pipe's schema history and pick a version it has. |
+| `secret_key_missing` | 1 | ask_human | none |  | Ask your administrator to finish this server's setup. |
+| `semantic_unavailable` | 6 | retry | none | 3 | The numbers are updating; retry in a moment. |
+| `service_account_key_invalid` | 1 | fix_and_retry | none |  | Send a valid service account key. |
+| `service_account_needs_access_role` | 1 | fix_and_retry | none |  | Pick at least one access role for the service account. |
+| `service_credential_exists` | 1 | fix_and_retry | none |  | Rotate the service account's credential for this warehouse to get a new password. |
+| `service_not_available` | 1 | ask_human | none |  | This feature is not part of this Databay product; ask support if you need it. |
+| `service_required` | 1 | fix_and_retry | none |  | Call the public route instead; this one accepts only Databay's own services. |
+| `service_updating` | 6 | retry | none | 6 | Databay is updating; retry in a minute. |
+| `session_revoke_failed` | 6 | retry | partial | 3 | Retry in a moment; the change is completed automatically once sign-out succeeds. |
+| `setup_script_not_found` | 1 | fix_and_retry | none |  | Set the source up by hand; this type has no setup script. |
+| `setup_step_unknown` | 1 | fix_and_retry | none |  | Ask for one of the steps the answer lists. |
+| `share_busy` | 6 | retry | none | 3 | Retry after the Retry-After interval. |
+| `share_in_use` | 1 | do_first | none |  | Delete or move those pipelines first; paused pipelines count too. |
+| `share_not_found` | 1 | fix_and_retry | none |  | List the resource's shares and pick one of them. |
+| `shared_readers_disabled` | 1 | fix_and_retry | none |  | Create the pipe without reader_id; it then gets a reader of its own. |
+| `shop_domain_invalid` | 1 | fix_and_retry | none |  | Send shop as <store>.myshopify.com. |
+| `shop_not_found` | 1 | ask_human | none |  | Install the app on a Shopify store first. |
+| `shopify_app_not_installed` | 1 | ask_human | none |  | Install the app for the shop. |
+| `shopify_hmac_invalid` | 1 | fix_and_retry | none |  | Send the request with a valid Shopify HMAC. |
+| `shopify_install_failed` | 6 | retry | unknown | 2 | Retry the install; contact support if it fails again. |
+| `shopify_session_invalid` | 1 | do_first | none |  | Reload the app in Shopify admin to get a new session. |
+| `shopify_shop_info_unavailable` | 6 | retry | none | 3 | Retry in a moment. |
+| `shopify_sign_in_failed` | 1 | ask_human | none |  | Reinstall the app. |
+| `shopify_source_undeletable` | 1 | ask_human | none |  | Uninstall the app from Shopify to remove this source. |
+| `shopify_store_not_found` | 1 | fix_and_retry | none |  | Check the store's address, then try again. |
+| `sibling_being_removed` | 6 | retry | none | 3 | Retry in a few minutes; another account of this type is still being removed. |
+| `sign_in_rate_limited` | 6 | retry | none | 1 | Check the key's secret, then retry after the Retry-After interval. |
+| `sink_column_type_required` | 1 | fix_and_retry | none |  | Retry without sink_column_type; the warehouse picks the column type. |
+| `sink_in_use` | 1 | do_first | none |  | Delete the pipelines listed in pipes first. |
+| `sink_not_found` | 1 | fix_and_retry | none |  | List the warehouses and pick one you can see. |
+| `sink_not_ready` | 1 | do_first | none |  | Wait until the destination warehouse is ready (retry it if it failed), then create the pipe again. |
+| `sink_provision_failed` | 6 | retry | unknown | 2 | Connect again; contact support if it keeps failing. |
+| `sink_user_exists` | 1 | fix_and_retry | none |  | Renew your warehouse user's password instead. |
+| `slot_release_failed` | 1 | ask_human | partial |  | Check that the source database is reachable, then release the pipe again. |
+| `source_check_run_active` | 6 | retry | none | 3 | Wait for the running check to finish, then read its result or check again. |
+| `source_check_run_not_found` | 1 | do_first | none |  | Check the source again to get a new result. |
+| `source_check_unreachable` | 6 | retry | none | 3 | Retry once the source database can be reached. |
+| `source_connection_failed` | 1 | fix_and_retry | none |  | Check the connection details and credentials for the failure detail names, then try again. |
+| `source_currency_unknown` | 1 | do_first | none |  | Try again once the store's data has synced; contact support if it persists. |
+| `source_deleting` | 1 | fix_and_retry | none |  | Pick another source; this one is being deleted. |
+| `source_has_live_pipes` | 1 | fix_and_retry | none |  | Send settings Databay can connect with; pipelines use this source. |
+| `source_host_changed_live_pipe` | 1 | do_first | none |  | Delete and re-create the pipe to stream from the new host. |
+| `source_in_use` | 1 | do_first | none |  | Delete the pipelines listed in pipes first, or cascade-delete. |
+| `source_name_taken` | 1 | fix_and_retry | none |  | Choose a name no other source in your organization uses. |
+| `source_needs_attention` | 1 | ask_human | none |  | Fix the setup checks in blocking_requirements on the source database, then check the source again. |
+| `source_needs_reauth` | 1 | ask_human | none |  | Reconnect the source to sign in again. |
+| `source_no_stored_pass` | 1 | do_first | none |  | Check the source with its active probes, on its Connect step or with the CLI, then create the pipe. |
+| `source_not_connected` | 1 | do_first | none |  | Reconnect the source first. |
+| `source_not_renewable` | 1 | do_first | none |  | Wait until the source finishes updating; a deleting or uninstalled source cannot be renewed. |
+| `source_not_visible` | 1 | ask_human | none |  | Ask a project admin for access to the projects of these sources. |
+| `source_operation_unsupported` | 1 | fix_and_retry | none |  | Skip this operation; this source or warehouse type cannot do it. |
+| `source_override_not_offered` | 1 | ask_human | none |  | Fix what the check found on the source database, then check the source again. |
+| `source_partition_check_unavailable` | 6 | retry | none | 3 | Retry once the source database can be reached. |
+| `source_partitioned_table_unsupported` | 1 | fix_and_retry | none |  | Create one pipe per partition of the table; a partition added later needs a pipe of its own. |
+| `source_pending` | 1 | do_first | none |  | Wait for the sources listed in pending to land their first data. |
+| `source_read_timeout` | 6 | retry | none | 3 | Retry; the source database took too long to answer. |
+| `source_refresh_unavailable` | 6 | retry | none | 3 | Retry in a moment. |
+| `source_refresh_used_today` | 1 | do_first | none |  | Wait for the daily sync, or refresh again tomorrow. |
+| `source_replica_identity_missing` | 1 | ask_human | none |  | Have the database admin give the table a primary key or a replica identity, then create the pipe again. |
+| `source_replication_slots_exhausted` | 1 | ask_human | none |  | Have the database admin raise max_replication_slots, or delete a pipe you no longer need on that source. |
+| `source_setup_incomplete` | 1 | ask_human | none |  | Fix the setup checks in blocking_requirements on the source database, then check the source again. |
+| `source_table_not_found` | 1 | fix_and_retry | none |  | Pick a table the source database has. |
+| `source_teardown_failed` | 1 | ask_human | partial |  | Check the source's pipelines and its database, then delete the source again. |
+| `source_type_not_offered` | 1 | fix_and_retry | none |  | Pick a source type this deployment offers. |
+| `source_uninstalled` | 1 | ask_human | none |  | Reinstall the source's app. |
+| `source_updating` | 6 | retry | none | 5 | Retry once the source reports connected. |
+| `source_wal_level_not_logical` | 1 | ask_human | none |  | Have the database admin set wal_level to logical and restart PostgreSQL, then create the pipe again. |
+| `staff_action_unknown` | 1 | fix_and_retry | none |  | Pick one of the actions this install lists. |
+| `staff_read_not_served` | 1 | ask_human | none |  | Ask an engineer to check which service serves this section on this install. |
+| `staff_read_unavailable` | 6 | retry | none | 3 | Try again in a minute; reading changed nothing. |
+| `staff_reauth_required` | 1 | do_first | none |  | Sign in to the staff console again with your one-time code, then retry. |
+| `staff_request_not_found` | 1 | fix_and_retry | none |  | Check the request key: no staff change was made under it. |
+| `staff_required` | 1 | do_first | none |  | Sign in to the staff console and retry from there. |
+| `stream_not_found` | 1 | fix_and_retry | none |  | Pick a stream the source has. |
+| `subscription_changed` | 6 | retry | none | 3 | Retry; the subscription changed while this ran. |
+| `support_delivery_failed` | 6 | retry | none | 2 | Retry; the message was not sent. |
+| `surface_disabled` | 1 | ask_human | none |  | Contact support, or whoever runs your Databay server, to turn project scoping on for this surface. |
+| `table_check_unavailable` | 6 | retry | none | 3 | The query was not run; retry in a moment. |
+| `table_checks_failed` | 1 | ask_human | none |  | Run the SQL shown for each table named, or remove it from this set, then try again. |
+| `table_not_found` | 1 | fix_and_retry | none |  | Pick a table the warehouse has. |
+| `token_invalid` | 3 | do_first | none |  | Sign in again, or send a valid API key. |
+| `token_refresh_failed` | 1 | do_first | none |  | Sign in again. |
+| `token_rejected` | 1 | fix_and_retry | none |  | Check that the token has not expired and has the needed scopes. |
+| `token_stale` | 3 | do_first | none |  | Sign in again to get a token with your current roles. |
+| `too_many_currencies` | 1 | fix_and_retry | none |  | Filter the card to fewer currencies. |
+| `too_many_properties` | 1 | fix_and_retry | none |  | Sync fewer properties in this connection. |
+| `unknown_dataset` | 1 | fix_and_retry | none |  | Pick a dataset from the dataset list. |
+| `unknown_feature` | 1 | fix_and_retry | none |  | Use a feature name from the feature list. |
+| `unknown_meter` | 1 | fix_and_retry | none |  | Use a meter name the plan has. |
+| `unknown_org` | 1 | fix_and_retry | none |  | Check the organization name. |
+| `unknown_override_keys` | 1 | fix_and_retry | none |  | Check each key in unknown, then skip the ones that do not exist. |
+| `unknown_plan` | 1 | fix_and_retry | none |  | List the plans and pick one of them. |
+| `unknown_version` | 1 | fix_and_retry | none |  | List the plan's versions and pick one of them. |
+| `unknown_warehouse` | 1 | fix_and_retry | none |  | Name only warehouses you have in the SQL. |
+| `unknown_warehouse_schema` | 1 | fix_and_retry | none |  | Name one of your warehouses in the schema path. |
+| `unsupported_currency` | 1 | fix_and_retry | none |  | Pick another reporting currency. |
+| `unsupported_sink` | 1 | ask_human | none |  | Contact support; this source needs a single-node warehouse, which this deployment does not have. |
+| `unsupported_sink_type` | 1 | fix_and_retry | none |  | Register a ClickHouse warehouse. |
+| `user_in_other_org` | 1 | fix_and_retry | none |  | Invite another email address; a person can belong to one organization only. |
+| `username_missing` | 1 | ask_human | none |  | Ask an admin to set a username on your account, then sign in again. |
+| `verification_email_unavailable` | 6 | retry | none | 3 | Try again in a minute. |
+| `version_in_use` | 1 | do_first | none |  | Move the subscriptions off this version first. |
+| `version_published` | 1 | do_first | none |  | Create a draft from this version and change that instead. |
+| `version_retired` | 1 | fix_and_retry | none |  | Use the plan's current version. |
+| `warehouse_credential_rejected` | 1 | ask_human | none |  | Ask your org admin to re-run the warehouse access reconcile. |
+| `warehouse_name_unsafe` | 1 | ask_human | none |  | Ask your Databay administrator to check this warehouse's database name. |
+| `warehouse_not_in_project` | 1 | fix_and_retry | none |  | Pick a warehouse available in this project. |
+| `warehouse_not_queryable` | 1 | fix_and_retry | none |  | Pick a warehouse Databay manages on your organization's analytics server; only those can be queried. |
+| `warehouse_not_visible` | 1 | fix_and_retry | none |  | Pick a warehouse from this project's list. |
+| `warehouse_required` | 1 | fix_and_retry | none |  | Name one of the project's warehouses. |
+| `warehouse_setup_invalid` | 1 | ask_human | none |  | Ask your Databay administrator to fix the warehouse settings; retrying will not help. |
+| `warehouse_unavailable` | 6 | retry | none | 3 | Retry after the Retry-After interval. |
+| `warehouses_not_ready` | 6 | retry | none | 3 | Retry after the Retry-After interval. |
+| `webhook_body_invalid` | 1 | fix_and_retry | none |  | Send the webhook with every required field. |
+| `webhook_forbidden` | 1 | fix_and_retry | none |  | Send alerts from this project instead. |
+| `webhook_replay_unavailable` | 1 | fix_and_retry | none |  | Send a new Idempotency-Key to create the webhook again. |
+| `webhook_signature_invalid` | 1 | fix_and_retry | none |  | Sign the webhook with the secret shown when the repository was connected. |
+| `webhook_url_undeliverable` | 1 | fix_and_retry | none |  | Use a URL this webhook type can deliver to. |
+| `workspace_unavailable` | 6 | retry | none | 3 | Retry after the Retry-After interval. |
+| `wrong_credentials` | 1 | fix_and_retry | none |  | Check the username and password, then sign in again. |
+
+## Pipe failure codes
+
+A pipe that fails records one of these in `error_code`; a wait that ends on the failure reports it.
+
+| Code | Action | Side effects | Max retries | Hint |
+|---|---|---|---|---|
+| `attach_timed_out` | retry | none | 2 | Retry the pipe; if it times out again, check the reader's state on the pipe. |
+| `attach_unsupported_source` | fix_and_retry | none |  | Create the pipe without reader_id; it then gets a reader of its own. |
+| `cdc_capture_instance_missing` | ask_human | none |  | Enable CDC on the table again, then resync the pipe. |
+| `cdc_capture_stopped` | ask_human | none |  | Start SQL Server Agent and the CDC capture job on the source; the pipe then catches up. |
+| `cdc_capture_stopped_azure` | ask_human | none |  | Check in Azure that the database isn't paused; the pipe catches up once capture runs. |
+| `cdc_column_missing` | fix_and_retry | unknown |  | Add the column back and restart the pipe, or create a new pipe without it. |
+| `cdc_ddl_unparseable` | ask_human | partial |  | Contact support with the error reference and the source's sql_mode. |
+| `cdc_engine_config_invalid` | fix_and_retry | unknown |  | Set the source's SSL mode to require, disable, verify-ca or verify-full, then restart the pipe. |
+| `cdc_engine_internal_error` | ask_human | unknown |  | Contact support with the error reference, then restart the pipe. |
+| `cdc_engine_panic` | ask_human | unknown |  | Contact support with the error reference, then restart the pipe. |
+| `cdc_engine_state_invalid` | ask_human | partial |  | Contact support to inspect the stored position before the pipe restarts. |
+| `cdc_engine_unavailable` | ask_human | none |  | Contact support to change the pipe's replication engine. |
+| `cdc_format_failed` | ask_human | partial |  | Contact support with the error reference; the pipe stays stopped. |
+| `cdc_offset_document_unsupported` | ask_human | partial |  | Contact support with the error reference; the pipe stays stopped. |
+| `cdc_partition_and_parent_configured` | do_first | unknown |  | Delete the pipe on the table or the one on its partition, or re-create it without reader_id. |
+| `cdc_partition_published_under_own_name` | ask_human | unknown |  | Have the database admin set publish_via_partition_root on the publication, then resync the pipe. |
+| `cdc_partition_published_under_parent` | ask_human | unknown |  | Have the database admin remove the parent from the publication, or create the pipe on the parent. |
+| `cdc_partitioned_table_unsupported` | ask_human | unknown |  | Upgrade the source to Postgres 13 or newer, or create one pipe for each partition. |
+| `cdc_publication_privilege_missing` | ask_human | unknown |  | Have the database admin make the source user the table's owner with CREATE, then restart the pipe. |
+| `cdc_publication_tables_missing` | ask_human | unknown |  | Have the database admin add the table to the publication, then restart the pipe. |
+| `cdc_record_malformed` | ask_human | partial |  | Contact Databay support with the error reference, then restart the pipe once they confirm a fix. |
+| `cdc_replication_privilege_missing` | ask_human | unknown |  | Have the database admin give the source user the replication privilege, then restart the pipe. |
+| `cdc_schema_bootstrap_unstable` | retry | none | 3 | Let the schema changes on the replicated tables finish, then retry the pipe. |
+| `cdc_schema_history_invalid` | ask_human | partial |  | Contact support with the error reference; resetting the pipe takes a new snapshot. |
+| `cdc_schema_retype_unsupported` | do_first | partial |  | Rebuild the pipe's table with the new type, or change the source column back, then restart the pipe. |
+| `cdc_select_privilege_missing` | ask_human | unknown |  | Have the database admin grant the source user SELECT on the table, then restart the pipe. |
+| `cdc_sink_rejected` | ask_human | partial |  | Contact support with the error reference; the pipe stays stopped until the cause is fixed. |
+| `cdc_slot_mismatch` | do_first | unknown |  | Delete and re-create the pipe so it gets a replication slot of its own. |
+| `cdc_snapshot_key_not_indexed` | fix_and_retry | unknown |  | Add a unique index on the table's key columns, then restart the pipe. |
+| `cdc_snapshot_start_unstable` | retry | none | 3 | Let the schema changes on the replicated tables finish, then retry the pipe. |
+| `cdc_source_auth_unsupported` | ask_human | unknown |  | Have the database admin use a supported sign-in method for the source user, then restart the pipe. |
+| `cdc_source_database_missing` | fix_and_retry | unknown |  | Correct the source's database name, then restart the pipe. |
+| `cdc_source_login_rejected` | ask_human | unknown |  | Have the database admin allow the source user to connect from Databay, then restart the pipe. |
+| `cdc_source_message_too_large` | ask_human | partial |  | Contact support to raise the limit or to leave out the oversized columns. |
+| `cdc_source_privilege_missing` | ask_human | unknown |  | Have the database admin give the source user what the source setup guide lists, then restart the pipe. |
+| `cdc_source_rejected` | ask_human | unknown |  | Have the database admin fix the source setting the error names, then restart the pipe. |
+| `cdc_source_setting_invalid` | ask_human | unknown |  | Have the database admin apply the binlog settings the error lists, then restart the pipe. |
+| `cdc_source_stream_invalid` | ask_human | partial |  | Contact support with the error reference; the pipe stays stopped. |
+| `cdc_source_table_missing` | fix_and_retry | unknown |  | Restore the table or grant the source user SELECT on it, then restart the pipe. |
+| `cdc_source_type_unsupported` | fix_and_retry | unknown |  | Create a new pipe that leaves the column out, or ask support to replicate unknown types as text. |
+| `cdc_table_key_mismatch` | fix_and_retry | unknown |  | Create a new pipe keyed by the table's primary key, or have the admin re-enable CDC on the pipe's key. |
+| `cdc_table_key_missing` | fix_and_retry | unknown |  | Add a primary key to the table and restart the pipe, or create a new pipe with a replication key. |
+| `changes_expired` | do_first | partial |  | Resync the pipe (a rebuild from the snapshot source) to copy the table again. |
+| `column_type_unsupported` | fix_and_retry | unknown |  | Create a new pipe that leaves the column out, or cast it to text in a view. |
+| `config_rejected` | fix_and_retry | none |  | Review the pipe's source, destination and replication key, then create it again. |
+| `consumer_progress_missing` | do_first | partial |  | Resync the pipe to copy the table again, and send the error reference to support. |
+| `decimal_too_wide` | fix_and_retry | unknown |  | Create a new pipe that leaves the column out, or cast it to a narrower type in a view. |
+| `dest_schema_rejected` | fix_and_retry | unknown |  | Point the pipe at a new destination table, or drop the existing table if you no longer need its data. |
+| `dest_unreachable` | retry | unknown | 3 | Retry the pipe; if it keeps failing, check the destination warehouse's connection details. |
+| `destination_table_incompatible` | fix_and_retry | none |  | Drop or rename the existing destination table and restart the pipe, or land it under another name. |
+| `file_cells_limit_reached` | fix_and_retry | none |  | Remove rows or columns from the tab or split it, then upload it again. |
+| `file_rows_limit_reached` | fix_and_retry | none |  | Remove rows from the tab or split it into smaller files, then upload it again. |
+| `file_tab_missing` | fix_and_retry | none |  | Upload a file that has the pipe's tab; the pipe runs again once it is confirmed. |
+| `file_unavailable` | do_first | none |  | Upload the file to the source again; the pipe runs once it is confirmed. |
+| `file_unreadable` | fix_and_retry | none |  | Fix the named tab or the file settings, then upload the file again. |
+| `file_value_type_mismatch` | fix_and_retry | none |  | Fix the value at the named tab, row and column, then upload the file again. |
+| `ingest_dependency_unavailable` | retry | none | 3 | Wait for the pipe to retry on its own; nothing needs changing. |
+| `internal_unclassified` | ask_human | unknown |  | Send the error reference to Databay support. |
+| `lane_spill_exhausted` | do_first | partial |  | Resync the pipe to copy the table again; contact support if it happens again. |
+| `lane_stalled` | do_first | partial |  | Check the pipe's errors, then resync the pipe to copy the table again. |
+| `mask_failed` | fix_and_retry | partial |  | Check that the masked columns still exist at the source, then restart the pipe. |
+| `new_columns_untracked` | fix_and_retry | none |  | Set the pipe to add new columns automatically, or turn schema change tracking on, then restart it. |
+| `pipe_not_provisioned` | retry | unknown | 5 | Wait for provisioning to finish and retry; if the pipe stays in this state, delete and re-create it. |
+| `pipe_shares_reader` | do_first | none |  | Delete or move the other pipes of the reader first. |
+| `publication_drift` | ask_human | partial |  | Have the database admin add the table back to the publication, then resync the pipe to fill the gap. |
+| `publication_missing` | do_first | partial |  | Re-create the pipe so Databay can set the source up again. |
+| `reader_engine_mismatch` | fix_and_retry | none |  | Create the pipe without reader_id, or switch the reader to this pipe's engine first. |
+| `reader_full` | fix_and_retry | none |  | Create the pipe without reader_id to give it a reader of its own. |
+| `reader_scope_required` | fix_and_retry | none |  | Send the request again with "scope": "reader"; the answer lists the pipes it changes. |
+| `replication_key_outside_identity` | fix_and_retry | none |  | Choose a replication key within the reader's identity columns, or create the pipe without reader_id. |
+| `replication_service_unavailable` | retry | unknown | 3 | Retry the pipe once the replication service is back; send the error reference to support if it persists. |
+| `replication_slot_lost` | do_first | partial |  | Delete and re-create the pipe for a fresh snapshot, then backfill the rows changed while it was stopped. |
+| `resync_required` | do_first | none |  | Resync the pipe (a rebuild from the snapshot source) to copy the table again. |
+| `saas_auth_expired` | ask_human | unknown |  | Reconnect the source, then sync again. |
+| `schema_incompatible` | fix_and_retry | partial |  | Rebuild the pipe's table, or revert the source change, then restart the pipe. |
+| `selection_invalid` | fix_and_retry | none |  | Create a new pipe with a primary key or with columns the source has, into a new destination table. |
+| `shared_readers_disabled` | fix_and_retry | none |  | Create the pipe without reader_id; it then gets a reader of its own. |
+| `shopify_protected_data_not_approved` | ask_human | unknown |  | The app owner must get Shopify's approval for protected customer data; syncing resumes then. |
+| `signal_table_denied` | ask_human | unknown |  | Ask the database administrator to grant the source user CREATE on that schema, then retry the pipe. |
+| `source_auth_failed` | fix_and_retry | unknown |  | Update the source's username and password, then retry the pipe. |
+| `source_binlog_status_unreadable` | ask_human | none |  | Ask the database administrator to grant REPLICATION CLIENT to Databay's user, then restart the pipe. |
+| `source_cdc_cleanup_passed` | ask_human | none |  | Raise the source's CDC cleanup retention, then resync the pipe to copy the table again. |
+| `source_column_reserved` | fix_and_retry | none |  | Rename the source column, or create a new pipe that leaves it out. |
+| `source_database_dropped` | do_first | partial |  | Once the database is back, resync the pipe (a rebuild from the snapshot source) to copy it again. |
+| `source_host_changed_live_pipe` | do_first | partial |  | Delete and re-create the pipe to stream from the new host. |
+| `source_host_not_allowed` | fix_and_retry | unknown |  | Point the source at your database's own public or private address, then retry the pipe. |
+| `source_permission_denied` | ask_human | unknown |  | Ask the database administrator to grant the privilege the error names, then retry the pipe. |
+| `source_replica_identity_missing` | ask_human | none |  | Have the database admin give the table a primary key or a replica identity, then create the pipe again. |
+| `source_replication_slots_exhausted` | ask_human | none |  | Have the database admin raise max_replication_slots or free a slot, then restart the pipe. |
+| `source_tls_rejected` | fix_and_retry | unknown |  | Check the source's SSL mode and certificate, then retry the pipe. |
+| `source_too_many_connections` | retry | unknown | 3 | Retry the pipe; if it keeps failing, free connections or raise max_connections on the source. |
+| `source_unreachable` | retry | unknown | 3 | Retry the pipe; if it still cannot connect, check the source's host, port and firewall rules. |
+| `source_wal_level_not_logical` | ask_human | none |  | Have the database admin set wal_level to logical and restart PostgreSQL, then create the pipe again. |
+| `subscriber_detached` | do_first | partial |  | Fix the cause shown with the code, then resync the pipe to copy the table again. |
+| `table_check_drift` | do_first | partial |  | Resync the pipe to see what the table needs; once that's fixed, the resync fills the gap. |
+| `table_quarantined` | do_first | partial |  | Fix the cause shown with the code, then resync the pipe to copy the table again. |
+| `topic_produce_failing` | do_first | partial |  | Resync the pipe to copy the table again; contact support if it happens again. |
+| `topic_produce_rejected` | ask_human | partial |  | Contact support to fix the pipe's topic, then resync the pipe to copy the table again. |
+| `transform_failed` | fix_and_retry | partial |  | Fix or revert the transform, then restart the pipe; it resumes from where it stopped. |
+| `transform_runtime_unavailable` | retry | unknown | 3 | Wait and retry; the pipe runs once the transform engine is back. |
+| `warehouse_version_too_old` | fix_and_retry | unknown |  | Upgrade the warehouse to ClickHouse 25.12 or later and restart the pipe, or leave the column out. |