Skip to Content
GrowSocialelion API
Read endpoints

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

NameTypeRequiredDescription
triggerstringNoA trigger id, e.g. "morning-scan", "mcp-client".
sinceDaysintegerNo
limitintegerNo
cursorstringNoThe 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.