Read agent runs
Recent agent and schedule runs of this brand, newest first, with what each produced (drafts kept, dismissed, waiting) and the window's spend per trigger...
GET | POST /api/v1/read_runs · MCP tool read_runs · scope read
Recent agent and schedule runs of this brand, newest first, with what each produced (drafts kept, dismissed, waiting) and the window's spend per trigger in credits. Bounded: sinceDays ≤ 90, limit ≤ 50, nextCursor. Free, from this app's store.
Scope. Read your own brand data: posts, metrics, runs, the audit trail, the plan, stored mentions and trends. Free, unless you ask a billed network for a fresh read. This endpoint never costs credits.
Arguments
| Name | Type | Required | Description |
|---|---|---|---|
trigger | string | No | A trigger id, e.g. "morning-scan", "mcp-client". |
sinceDays | integer | No | |
limit | integer | No | |
cursor | string | No | The nextCursor from the previous page. Omit for the newest. |
Request
curl -X POST https://growsocialelion.com/api/v1/read_runs \
-H "Authorization: Bearer gse_mcp_YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{}'Response
200 with the tool's answer. The shape below is generated from the output schema; real answers can carry more fields.
{
"status": "string",
"code": "string",
"reason": "string",
"runs": [
{
"runId": "string",
"trigger": "string",
"startedAt": "string"
}
],
"nextCursor": "string"
}Errors use the shared body. See Errors. The full schema is in the API reference.