GraphQL Changelog – June 16

A new mutation lets users export multi-organization usage reports. The report is generated asynchronously and delivered by email, mirroring the single-organization Usage Stats export.

Added:

• The mutation createMultiOrgUsageReportExport triggers an asynchronous usage report export aggregated across multiple organizations. Input:
  • organizationUuids: [ID!]! — the organizations to include (1..25); only those the caller may see usage stats for are included.
  • period: PeriodFilter! — current_month, last_month, or last_3_months.
  • resourceType: MultiOrgUsageResourceType! — api (AI credits and automations follow).
  • Returns { status } (created on a successful trigger).

Notes:

• The mutation is gated by the multi_org_usage_stats feature flag; it is hidden from introspection and rejected unless the flag is enabled for the caller's organization.
• The report is emailed to the requesting user when ready — there is no polling query in this release.
• resourceType accepts ai_credit and automation as values, but only api produces a report at this time; the others are rejected until their exporters ship.