Additional AI Integrations

Submit usage data from additional AI tools. This allows AI tools to report their usage metrics to Swarmia for unified tracking.

Submit AI tool usage report

post

Submit daily usage metrics for an external AI tool. Each request can include data for multiple users and dates. Metrics are upserted based on the combination of (aiService, user email, date).

The API token must have the aiUsage scope enabled.

Authorizations

bearerToken

AuthorizationstringRequired

API token passed as Authorization: Bearer <token>. The token must have the entityQuery scope enabled. Tokens can be provisioned at https://app.swarmia.com/settings/api-tokens.

Body

application/json

aiServicestringRequired

AI tool identifier (e.g. Kiro). Alphanumeric, preferably PascalCase. Created automatically if new. Visible in reports.

Example: KiroPattern: ^[A-Za-z0-9]+$

Responses

200

Report accepted successfully.

application/json

objectOptional

400

Validation error.

application/json

401

Missing or invalid API token.

403

Token lacks aiUsage scope.

post/ingest/ai-usage

HTTPcURLJavaScriptPython

POST /api/v1/ingest/ai-usage HTTP/1.1
Host: app.swarmia.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 648

{
  "aiService": "Kiro",
  "data": [
    {
      "email": "[e-mail]",
      "date": "2025-09-01",
      "is_enabled": true,
      "is_active": true,
      "subscription_tier": "pro",
      "messages_count": 142,
      "conversations_count": 23,
      "spend_currency": "USD",
      "subscription_spend_minor": 2000,
      "extra_usage_allowed": true,
      "extra_usage_limit_minor": 5000,
      "extra_usage_spend_minor": 1250,
      "breakdowns": [
        {
          "model": "claude-sonnet-4-20250514",
          "client": "vscode",
          "programming_language": "typescript",
          "messages_count": 85,
          "conversations_count": 14,
          "tokens_input": 2400000,
          "tokens_output": 600000
        }
      ]
    },
    {
      "email": "[e-mail]",
      "date": "2025-09-01",
      "is_enabled": true,
      "is_active": false,
      "subscription_tier": "pro"
    }
  ]
}

{}