curl -X POST https://suite.sundaypyjamas.com/api/v1/artifacts/generate \
  -H "Authorization: Bearer spj_ai_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "templateId": "insight-narrative-v1",
    "scope": { "level": "organization", "label": "Acme Inc." },
    "period": { "start": "2026-04-01", "end": "2026-06-30" },
    "input": {
      "aggregates": {
        "recordCount": 4210,
        "metrics": { "activeUsers": 1893, "churnRate": 0.042 },
        "breakdowns": [
          { "dimension": "plan", "rows": [ { "key": "pro", "count": 1200 }, { "key": "free", "count": 3010 } ] }
        ]
      },
      "samples": [
        { "id": "u_1", "fields": { "plan": "pro", "lastActive": "2026-06-28" } }
      ],
      "context": { "instructions": "Focus on churn drivers.", "locale": "en-US" }
    }
  }'

{
  "data": {
    "templateId": "insight-narrative-v1",
    "outputSnapshot": {
      "version": 1,
      "generatedAt": "2026-07-08T10:00:00Z",
      "templateId": "insight-narrative-v1",
      "scope": { "level": "organization", "label": "Acme Inc." },
      "period": { "start": "2026-04-01", "end": "2026-06-30" },
      "source": { "type": "customer_payload", "recordCount": 4210, "sampleCount": 1 },
      "llm": {
        "executiveSummary": "Acme's active user base grew steadily through Q2...",
        "insights": [
          {
            "title": "Free-to-pro conversion is slowing",
            "body": "Only 8% of new free users converted to pro this quarter, down from 12%.",
            "category": "implementation_pressure",
            "evidence": ["1200 pro / 4210 total"]
          }
        ],
        "followUpConsiderations": [
          {
            "title": "Investigate onboarding drop-off",
            "body": "Session data suggests most churn happens in the first 7 days.",
            "attentionLevel": "elevated"
          }
        ],
        "confidenceNotes": "Based on a 4210-record sample with moderate breakdown coverage."
      }
    },
    "usage": {
      "model": "google/gemini-2.5-flash",
      "inputTokens": 812,
      "outputTokens": 340,
      "costUsd": 0.0021,
      "providerSlug": "google"
    }
  },
  "meta": { "requestId": "9f2a...", "persisted": false }
}