GrowthQ API

The GrowthQ API lets you integrate autonomous content generation into your own systems. Trigger AI agents, manage brand workspaces, and access content output programmatically.

Base URL: https://api.growthq.maveriqinsure.com

All requests must include authentication headers. See Authentication below.

Authentication

Every request requires an API key passed as a Bearer token in the Authorization header, along with the organization ID you're acting within.

# All API requests require these headers
curl https://api.growthq.maveriqinsure.com/orgs/me \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "X-Org-ID: YOUR_ORGANIZATION_ID"

API keys are not yet publicly available. GrowthQ is currently in private beta. Contact us to request early API access.

Rate limits

Requests are rate-limited per organization using a 60-second sliding window. Limits vary by plan:

Plan	Limit
Starter	100 requests / minute
Growth	500 requests / minute
Scale	2,000 requests / minute
Enterprise	Unlimited

Rate limit status is returned on every response: X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset

Errors

All errors return a JSON body with a detail field.

Status	Meaning
400	Bad request — check your request body
401	Missing or invalid API key
402	Insufficient credits
403	Forbidden — your role doesn't permit this action
404	Resource not found (or belongs to another org)
409	Conflict — duplicate slug, existing invite, etc.
415	Wrong Content-Type (must be application/json)
429	Rate limit exceeded
500	Internal server error

Organizations

GET /orgs/me

Returns the active organization for the authenticated caller.

PATCH /orgs/me

Update the organization name or settings. Requires admin role.

Brands

A brand represents a content workspace — voice profile, target audience, industry context. Agents use this data to generate on-brand content.

GET /brands

List all brands in the organization.

POST /brands

Create a new brand workspace. Requires editor role.

GET /brands/{id}

Get a single brand by ID.

PATCH /brands/{id}

Update a brand. Supports partial updates — only include fields you want to change.

Field	Type		Description
name	string	optional	Brand display name
website_url	string	optional	Brand website URL
industry	string	optional	Industry category
voice_profile	object	optional	Brand voice — tone, key_phrases, avoid
target_audience	object	optional	Audience — description, pain_points, age_range

Team & Invites

GET /orgs/me/members

List all members of the organization.

POST /orgs/me/invites

Create an invite link for a new teammate. Returns an invite_link to share. Requires admin role.

POST /invites/accept

Accept an invite token. The caller becomes a member of the inviting org.

Credits

Credits are consumed each time an agent runs. The cost depends on the agent type.

GET /orgs/me/credits/balance

Returns current balance, plan limit, usage percentage, and per-agent credit costs.

GET /orgs/me/credits

Credit transaction history, newest first. Supports limit and offset.

Agent Runs

Agent runs are the core of GrowthQ. Each run triggers an AI agent to perform a specific task for a brand. Credits are deducted on creation.

Agent type	Cost	What it does
trend_intelligence	5 cr	Scans platforms for viral trends in your niche
market_research	10 cr	Analyses competitor reviews and customer sentiment
content_strategy	10 cr	Generates hooks, angles, content calendar
script_generation	15 cr	Writes video scripts in your brand voice
copywriting	5 cr	Captions, CTAs, and hashtags per platform
analytics	2 cr	Analyses performance data
optimization	5 cr	Identifies what is working and scales it
growth_commander	20 cr	Orchestrates all agents, generates daily report

POST /agent-runs

Trigger a new agent run. Credits are deducted immediately.

{
  "agent_type": "content_strategy",
  "brand_id": "uuid",          // optional
  "input": {}                    // optional context
}

The run starts in pending status and transitions to running → completed (or failed) as the agent processes it.

GET /agent-runs/{id}

Poll this endpoint to check run status. When status === "completed", the output field contains the agent's results.

PATCH /agent-runs/{id}/cancel

Cancel a pending run. Credits are refunded automatically.

Interactive API explorer ↗ Request API access ← growthq.maveriqinsure.com