POST /usage/transactions

{
  "provider": "openai",
  "model": "gpt-4o",
  "usage": [{
    "type": "tokens",
    "metrics": {
      "input_tokens": 100,
      "output_tokens": 50,
      "total_tokens": 150
    }
  }],
  "context": {
    "billable_customer_id": "my-company"
  }
}

{
  "transactions": [
    { "provider": "openai", "model": "gpt-4o", ... },
    { "provider": "anthropic", "model": "claude-3-5-sonnet", ... }
  ]
}

{
  "context": {
    "billable_customer_id": "acme-corp"
  }
}

curl -X POST 'https://ingest.fenra.io/usage/transactions' \
  -H 'Content-Type: application/json' \
  -H 'X-Api-Key: YOUR_API_KEY' \
  -d '{
    "provider": "openai",
    "model": "gpt-4o",
    "usage": [{
      "type": "tokens",
      "metrics": {
        "input_tokens": 100,
        "output_tokens": 50,
        "total_tokens": 150
      }
    }],
    "context": {
      "billable_customer_id": "my-company"
    }
  }'

{
  "status": "queued",
  "events_queued": 1,
  "message": "1 transaction(s) queued for processing",
  "results": [{
    "transaction_index": 0,
    "message_id": "abc123-def456-ghi789"
  }]
}

{
  "error": {
    "code": "validation_error",
    "message": "Request validation failed",
    "details": [
      {
        "field": "context.billable_customer_id",
        "code": "required",
        "message": "billable_customer_id is required"
      }
    ]
  }
}

{
  "error": {
    "code": "unauthorized",
    "message": "Invalid or missing API key"
  }
}

{
  "status": "partial_success",
  "events_queued": 1,
  "events_failed": 1,
  "message": "1 transaction(s) queued, 1 transaction(s) failed",
  "results": [
    {
      "transaction_index": 0,
      "message_id": "abc123"
    },
    {
      "transaction_index": 1,
      "message_id": null,
      "error": "Validation failed"
    }
  ]
}