Skip to main content
Reports usage for multiple customers/features in a single request.

Mutation

mutation ReportUsageBulk($input: ReportUsageBulkInput!) {
  reportUsageBulk(input: $input) {
    measurementId
    currentUsage
  }
}
{
  "input": {
    "usages": [
      {
        "customerId": "customer-123",
        "featureId": "feature-api-calls",
        "value": 100
      },
      {
        "customerId": "customer-456",
        "featureId": "feature-api-calls",
        "value": 250
      },
      {
        "customerId": "customer-789",
        "featureId": "feature-storage",
        "value": 1.5,
        "updateBehavior": "SET"
      }
    ]
  }
}
{
  "data": {
    "reportUsageBulk": [
      {
        "measurementId": "measure-001",
        "currentUsage": 4632
      },
      {
        "measurementId": "measure-002",
        "currentUsage": 1250
      },
      {
        "measurementId": "measure-003",
        "currentUsage": 1.5
      }
    ]
  }
}

Parameters

input
ReportUsageBulkInput
required
Input for bulk usage reporting

Return Type

Returns an array of UsageMeasurementWithCurrentUsage objects.

Common Use Cases

Report accumulated usage from a background job.
Sync usage data from external systems.