Flow

Flow Agent API

Scheduled cross-suite reports and custom workflows — with real scheduling, async runs, and WhatsApp delivery of results.

Flow automates: scheduled reports, cross-suite workflows, and SOPs. This is the tool that turns "my agent should send me a weekly pulse on WhatsApp" into three API calls.

Endpoint and auth

POST https://flow.qweaver.com/api/agent
Authorization: Bearer <your qwa_ key>   # needs the flow grant

Highlights from the live manual

  • create_report — a scheduled cross-suite report over sources like core, helix_leads, loom_social, campaigns, forge, nexus, web_analytics, search_console; real scheduling with time, IANA timezone, and daysOfWeek; format text or a branded PDF.
  • create_workflow — custom multi-step recipes with named write steps (for example core_create_followup, nexus_award_points); confirm the owner’s intent before scheduling anything that executes writes.
  • run_report / run_workflow — ASYNC: returns 202 with a jobId to poll; idempotencyKey makes retries safe (the same key returns the original job, deduped).
  • deliverWhatsapp — results with a WhatsApp number auto-deliver. Delivery is an output destination, not permission to message arbitrary recipients.
  • Email is guard-railed at the send layer and agents cannot bypass it: notification-kind only, a single recipient per call, suppression list always wins, out-of-hours sends defer.
  • Runs are metered on Nexus credits and logged.

The live manual

curl
curl -s https://flow.qweaver.com/api/agent