Skip to Content
GrowSocialelion API
Read endpoints

List brands

The brands this key may act for, with connected networks and whether the agent is halted.

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

The brands this key may act for, with connected networks and whether the agent is halted. Every other tool answers for ONE brand: choose it with the X-GSE-Brand header (a brandId from here), or omit the header for the first. Free, from this app's store; no agent run.

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

None. Send an empty body or {}.

Request

curl -X POST https://growsocialelion.com/api/v1/list_brands \
  -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",
  "brands": [
    {
      "brandId": "string",
      "name": "string",
      "current": false,
      "halted": false
    }
  ]
}

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