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
| Name | Type | Required | Description |
|---|---|---|---|
verb | string | No | |
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 | |
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/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.