Quickstart

This quickstart covers the Cascades API path for demo environments—validate integrations or trigger webhook-driven runs. Use https://cascades.work as the base URL in production; use your local origin (for example http://localhost:3000) when running next dev.

Set BASE to your target origin so the same commands work in either environment:

export BASE=https://cascades.work   # production
# export BASE=http://localhost:3000   # local next dev

1. Seed integrations

curl -X POST "${BASE}/api/integrations/seed-demo" \
  -H "Content-Type: application/json" \
  -d '{"tenantId":"demo","userId":"demo-operator","overwrite":true}'

2. Verify integrations

curl "${BASE}/api/integrations"
curl "${BASE}/api/integrations/catalog"

3. Trigger a webhook run

The Make webhook example triggers a demo workflow using the demo tenant and a shared demo secret.

curl -X POST "${BASE}/api/integrations/make/webhook?tenantId=demo" \
  -H "Content-Type: application/json" \
  -H "x-cascades-make-secret: demo-demo-make-secret" \
  -d '{"eventType":"demo.run","eventId":"evt-demo-make-001","payload":{"source":"quickstart"}}'

Next steps

• Review the workflow catalog to choose a default workflow.
• Review the integrations reference to map provider endpoints.
• Open the dashboard to inspect workflow runs and proof records.
• Use the Python SDK from PyPI (cascades-sdk) or clone https://github.com/no1rstack/cascades-sdk; see SDK documentation for capture-mode authoring and the mirrored HTTP contract.