GOGOGOLLC
Back to ResourcesLive

Documentation

Preview — the SDK and API shown here are illustrative and not yet generally available.

Build with multi-agent APIs.

One platform, one auth scheme, four product surfaces. Every endpoint is an orchestrator run — observable, replayable, and reversible from the dashboard.

Start the quickstartGet an API key
GoBot in a developer terminal — multi-agent API documentation

Quickstart

Three commands to first agent call.

You install the SDK, set a project key, and trigger your first orchestrator run. The CLI walks you through scoping the key to a product surface (Goddo, GoVista, GoPeople, or GoTrack) on the first run.

  • Need a key first? Email [email protected].
  • Drop-in SDKs for TypeScript, Python and Go.
  • Every CLI command prints the equivalent REST call.
bashapi.gogogo.dev
# 1. Install the SDK
npm install @gogogo/sdk

# 2. Authenticate with your project key
export GOGOGO_API_KEY="sk_live_…"

# 3. Run your first agent call
npx gogogo agent run goddo.image.generate \
  --prompt "A neon GoBot delivering a parcel" \
  --aspect 9:16
httpapi.gogogo.dev
POST https://api.gogogo.dev/v1/agents/run
Authorization: Bearer sk_live_…
Content-Type: application/json

{
  "agent": "govista.schedule",
  "tenant": "acme-retail",
  "input": {
    "campaign": "spring-launch",
    "windows": ["weekday-am", "weekend"]
  }
}

REST API

One verb. Many specialists.

Almost every operation goes through a single endpoint — /v1/agents/run — with the agent name in the body. The orchestrator picks the right specialist and tools, and the response carries a trace_id you can replay end-to-end.

  • Orchestrator runs

    Every API call is an orchestrator run. The orchestrator decides which specialist agents handle each step, calls the tools, and ships outcomes.

  • Tenants & scopes

    Resources are scoped to a tenant. API keys carry a tenant prefix; you can mint scoped sub-keys per product or per environment.

  • Idempotency

    Pass an Idempotency-Key on any POST. Retries within 24h return the original run instead of re-executing the agents.

  • Observability

    Every run emits a trace_id. Open it in the dashboard to inspect every hand-off, tool call, and decision — replay or roll back from there.

Per-product surfaces

Four products, one orchestrator.

Each product exposes its own endpoints under /v1/<product>/…. The schemas are stable; the orchestrator behind them is upgraded weekly.

  • goddo logo

    Goddo

    Image / video generation API

    Submit prompts, refine renders, fetch the asset library, and get notified on completion.

    • POST/v1/goddo/images
    • POST/v1/goddo/refine
    • GET/v1/goddo/library
    • WEBHOOKgoddo.render.completed
  • govista logo

    GoVista

    Digital signage CMS API

    Provision devices, schedule playlists across zones, and stream audience-event telemetry into your warehouse.

    • POST/v1/govista/devices
    • POST/v1/govista/playlists
    • GET/v1/govista/zones
    • WEBHOOKgovista.audience.event
  • gopeople logo

    GoPeople

    WhatsApp HR API

    Bind WhatsApp Business numbers, route classified intents, run leave / document workflows, audit-ready logs.

    • POST/v1/gopeople/threads
    • POST/v1/gopeople/workflows
    • GET/v1/gopeople/audit
    • WEBHOOKgopeople.message.classified

  • GoTrack

    Computer-vision retail API

    Pickup events, FAISS similarity queries, hanger zone scoring, signed pulse webhooks for live dashboards.

    • POST/v1/gotrack/zones
    • POST/v1/gotrack/similarity
    • GET/v1/gotrack/score
    • WEBHOOKgotrack.pickup.detected

Webhooks

Signed events, replayable.

Every product emits its own event stream. Each delivery carries an x-gogogo-signature HMAC, a trace_id, and a stable event name — product.entity.action. Failed deliveries retry with exponential backoff and are replayable from the dashboard.

  • Examples: goddo.render.completed · govista.audience.event · gopeople.message.classified · gotrack.pickup.detected.
  • Rotate signing secrets per environment. Verification helpers ship in every SDK.
tsapi.gogogo.dev
// Verify a GOGOGO webhook with your signing secret.
import { verifyWebhook } from "@gogogo/sdk/webhooks";

export async function POST(req: Request) {
  const ok = await verifyWebhook({
    body: await req.text(),
    signature: req.headers.get("x-gogogo-signature")!,
    secret: process.env.GOGOGO_WEBHOOK_SECRET!,
  });
  if (!ok) return new Response("invalid signature", { status: 400 });
  // …handle event…
}

SDKs

Typed clients, generated from OpenAPI.

The OpenAPI spec is the source of truth. SDKs regenerate on every release — you stay typed without us having to maintain four parallel client libraries by hand.

  • TypeScript / Node

    npm install @gogogo/sdk

    Stable · v0.6

  • Python

    pip install gogogo-sdk

    Stable · v0.5

  • Go

    go get github.com/gogogollc/gogogo-go

    Beta

  • OpenAPI spec

    curl https://api.gogogo.dev/openapi.yaml

    Always current

Support

Stuck on something specific?

Send us your trace_id and the endpoint you're calling. We answer within one business day, and we have eyes on every run from the dashboard.

Talk to engineeringOpen Help Center