Skip to Content
GrowSocialelion API
Read endpoints

Proposal or session status

Status of a proposal or of a growth-agent session.

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

Status of a proposal or of a growth-agent session. Pass proposalId (from propose_post) to read the Inbox row's real state: awaiting_human_approval, scheduled, published (with its URL), or dismissed. Pass sessionId to summarize a run: what state it is in, why it failed if it did, and the last tool outcome. An id this app has no record of is reported as such. For the brand's autonomy settings — who gets asked before an action — call get_capabilities.

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
proposalIdstringNoA proposalId from propose_post.
sessionIdstringNoA session id from any tool's `session`.

Request

curl -X POST https://growsocialelion.com/api/v1/session_status \
  -H "Authorization: Bearer gse_mcp_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"proposalId":"prop_123"}'

Response

200 with the tool's answer. The shape below is generated from the output schema; real answers can carry more fields.

{
  "status": "string",
  "reason": "string"
}

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