Reference
Troubleshooting
Diagnose common local, authentication, and runtime problems.
The CLI cannot authenticate
Confirm that COMPAOS_API_KEY is available to the process and belongs to the current project. If the key was copied with surrounding quotes or spaces, remove them and restart the process.
A workflow is not found
Workflow identifiers are case-sensitive. Check the identifier passed to workflow() and verify that the deployed version belongs to the selected project and environment.
A run stays queued
Check the service status linked from the docs header. If services are healthy, confirm the project has execution capacity and the workflow has a currently deployed version.
A retry creates duplicate data
The provider call is not idempotent. Pass an idempotency key where supported, or add a lookup step that confirms the external record does not already exist before creating it.
Get help
Include the run ID and request ID when contacting support. Do not send API keys, access tokens, or unredacted customer data.