Skip to main content

Troubleshooting

Fathom Webhook Returns 503​

Cause: FATHOM_WEBHOOK_SECRET is not set.

Fix:

cd sable-agents-demo/supabase
supabase secrets set FATHOM_WEBHOOK_SECRET='whsec_...'

Current state: the secret is set.

Fathom Webhook Returns 401​

Cause: Missing, stale, or invalid Fathom signature.

Unsigned curl smoke tests should return 401. That means the public route is deployed and the HMAC gate is active.

Asana Execution Returns 412​

Likely causes:

  • Approval is not approved.
  • Approval was already claimed/executed.
  • ASANA_ACT_WRITES_ENABLED is not true.

This is expected when writes are intentionally dark.

Cockpit Shows No Hours​

Check:

  • TOGGL_API_KEY exists.
  • toggl-sync is deployed.
  • Run { "dryRun": true, "hours": true } first.
  • Confirm matched project counts.
  • Run { "hours": true } only after preview looks right.

Ask SABLE Has No Document Citations​

Check:

  • VOYAGE_API_KEY is configured.
  • Documents have embeddings.
  • match_knowledge_chunks_scoped RPC exists.
  • knowledge_chunks has rows for the relevant project and source.
  • The viewer has access to the document's project.

If embeddings are absent, chat should still answer from structured spine data.

Fix the linked path or remove the link. onBrokenLinks: "throw" is intentional.