Skip to Content
GrowSocialelion API
Read endpoints

Query the audit trail

This brand's audit trail, newest first: who did what, when, under which approval.

GET | POST /api/v1/query_audit · MCP tool query_audit · scope read

This brand's audit trail, newest first: who did what, when, under which approval. Filters: verb prefix (e.g. "post."), actor kind, surface, network (matched on the row's subject only). Bounded: sinceDays ≤ 90, limit ≤ 200, nextCursor. Credits, never dollars. Free text in a row (details, reasons, errors) comes back only under `untrusted`, keyed by event id. 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
verbstringNo
actorKind"user" | "agent" | "schedule" | "system"No
surface"ui" | "chat" | "cron" | "extension" | "mcp" | "api"No
network"x" | "bluesky" | "mastodon" | "pixelfed" | "telegram" | "devdotto" | "discord" | "ghost" | "lemmy" | "nostr" | "tumblr" | "wordpress" | "misskey" | "qiita" | "tabnews" | "youtube" | "dailymotion" | "tiktok" | "hashnode" | "peertube" | "dribbble" | "slack" | "wykop" | "plurk" | "kick" | "twitch" | "hatena" | "line"No
sinceDaysintegerNo
limitintegerNo
cursorstringNoThe nextCursor from the previous page. Omit for the newest.

Request

curl -X POST https://growsocialelion.com/api/v1/query_audit \
  -H "Authorization: Bearer gse_mcp_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"sinceDays":7,"limit":20}'

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",
  "events": [
    {
      "id": "string",
      "at": "string",
      "verb": "string"
    }
  ],
  "nextCursor": "string",
  "untrusted": {
    "notice": "string"
  }
}

Errors use the shared body. See Errors. The full schema is in the API reference.