API Reference

https://api.moonage.ai/v1

curl -H "Authorization: Bearer YOUR_API_KEY" \
  https://api.moonage.ai/v1/spaces

GET /spaces

{
  "data": [
    {
      "id": "sp_abc123",
      "name": "Engineering",
      "status": "active",
      "created_at": "2025-01-15T10:30:00Z",
      "integrations": ["github", "linear", "slack"]
    }
  ],
  "pagination": {
    "total": 5,
    "limit": 20,
    "offset": 0
  }
}

POST /spaces

{
  "name": "Product Team",
  "description": "Product management workflows",
  "persona": "product-manager",
  "model": "sonnet"
}

GET /spaces/:id

PATCH /spaces/:id

DELETE /spaces/:id

POST /spaces/:id/messages

{
  "content": "Summarize all open PRs in the auth-service repo",
  "stream": true
}

event: progress
data: {"step": "Fetching GitHub PRs", "status": "running"}

event: progress
data: {"step": "Fetching GitHub PRs", "status": "completed", "duration_ms": 1200}

event: progress
data: {"step": "Summarizing results", "status": "running"}

event: result
data: {"content": "Here are the open PRs...", "tool_calls": [...]}

event: done
data: {"total_duration_ms": 3400}

GET /spaces/:id/messages

POST /spaces/:id/actions

{
  "prompt": "Generate a weekly report of all merged PRs",
  "output": {
    "type": "slack",
    "channel": "#engineering-updates"
  }
}

GET /spaces/:id/actions/:actionId

{
  "id": "act_xyz789",
  "status": "completed",
  "prompt": "Generate a weekly report...",
  "steps": [
    {
      "name": "Fetch merged PRs",
      "status": "completed",
      "duration_ms": 1500,
      "tool": "github.list_pull_requests"
    },
    {
      "name": "Summarize and format",
      "status": "completed",
      "duration_ms": 2100,
      "tool": "llm.summarize"
    },
    {
      "name": "Post to Slack",
      "status": "completed",
      "duration_ms": 800,
      "tool": "slack.post_message"
    }
  ],
  "total_duration_ms": 4400,
  "created_at": "2025-02-01T14:00:00Z"
}

GET /spaces/:id/integrations

POST /spaces/:id/integrations

DELETE /spaces/:id/integrations/:provider

{
  "error": {
    "code": "rate_limit_exceeded",
    "message": "Too many requests. Retry after 30 seconds.",
    "retry_after": 30
  }
}

X-RateLimit-Limit: 100
X-RateLimit-Remaining: 95
X-RateLimit-Reset: 1706803200

async function fetchWithRetry(url: string, options: RequestInit, retries = 3) {
  for (let i = 0; i < retries; i++) {
    const res = await fetch(url, options);
    if (res.status === 429) {
      const retryAfter = parseInt(res.headers.get("Retry-After") || "5");
      await new Promise((r) => setTimeout(r, retryAfter * 1000));
      continue;
    }
    return res;
  }
  throw new Error("Max retries exceeded");
}

POST /webhooks

{
  "url": "https://your-app.com/webhooks/moonage",
  "events": ["action.completed", "action.failed", "space.updated"],
  "secret": "your-webhook-secret"
}

import { createHmac } from "crypto";

function verifyWebhook(payload: string, signature: string, secret: string) {
  const expected = createHmac("sha256", secret).update(payload).digest("hex");
  return signature === `sha256=${expected}`;
}