Guides / Pull Results Into Reporting
Pull Results Into Reporting
Read the same scoreboard the agent reads, plus workflows and run history, into your own dashboards.
GET /api/v1/results returns the scoreboard the agent wakes up with: per-channel sections for email, ads, SEO, social and more, over a window ending now.
Available or not, never a fake zero
Each section is either { "available": true, "data": {…} } or { "available": false, "reason": "…" }. Zero and unknown are different numbers and the API never turns one into the other. Render an unavailable section as "not connected" or "not tracked", not as 0.
Windows
since is epoch milliseconds and is clamped to the last seven days; the default is 24 hours. Pull once an hour into your warehouse and you have everything the agent sees.
Workflows and runs
GET /api/v1/workflows lists recurring workflows with their schedule, next run and steps. GET /api/v1/workflows/{id}/runs is the run history with per-step outcomes, newest first, so a failed step shows up in your monitoring the same hour it happens.
Agents: this page is also markdown at /docs/pull-results-into-reporting.md, answers Accept: text/markdown, and is listed in /docs/llms.txt.
Frequently Asked Questions
Yes. Both read the same results window, so the number in your report matches the number in the agent's daily review.