Skip to content
CCOMMERCE OS
ProductHow it worksIntegrationsPricingSecurityDocs
Sign inStart free
Menu
ProductHow it worksIntegrationsPricingSecurityDocsSign inBook a demo
Commerce OS docs
Documentation homeGetting startedConnect integrationsBuild workflowsApprovals and logsTroubleshooting
Open workspace
Troubleshooting

Find the first broken dependency.

Most failures become understandable when you start from the task or request ID and follow the timeline to the first failed provider or missing configuration.

Common failures

Provider key saves but the model is unavailable

Run the provider connection test, inspect the server response, then sync models. A routing dropdown should show only models returned by a verified connection.

Composio says an API key is required

Add the key for the current organisation in Settings. Then verify the target toolkit has an auth configuration in the same Composio project.

OAuth opens an invalid app or missing client ID page

The provider application is not fully configured. Check the client ID, secret, redirect URL and enabled product before retrying.

n8n returns Unexpected token <

The configured URL returned HTML, commonly a login page, editor route or proxy error. Use the active production webhook endpoint and return JSON.

Image or carousel is blocked

Verify a connected image model is selected, the provider returns a usable image artifact, storage accepts it and every requested slide has a durable reference.

Local database reports a missing column

The Prisma schema and database are out of sync. Apply the intended migration to the correct database, regenerate the client and restart the server.

The app refreshes to the wrong state

Verify the route encodes the active workspace or window state and that organisation state is loaded before restoring it. Avoid relying only on in-memory client state.

Escalation evidence

Before escalating, capture the organisation ID, task ID, run or execution ID, time in IST, first error message, provider response status and whether the failure reproduces. Do not include secret values in logs or screenshots.

Current local note
If SystemSetting fields exist in Prisma but not in the connected database, repair the migration state first. Provider failures may be secondary noise caused by the settings query failing.
COMMERCE OS

A desktop for commerce teams. Orders, inventory, finance, campaigns and an AI workforce share one organisation.

ExploreProductHow it worksIntegrationsPricingSecurityDocs
AccountStart freeSign inBook a demoPrivacyTermsABATA
© 2026 ABATA · Commerce OS