Skip to content

Feature request: Expose Grok Build usage quota and voice usage endpoints #196

Description

@NYTEMODEONLY

Request

Add public SDK/API support for querying Grok Build usage quotas and voice usage — data that's currently only visible in the console dashboard but not exposed via any public endpoint.

What We See in the Console

When logged into console.x.ai, users can see:

  • Grok Build usage — weekly quota progress (e.g. "2% used for the week")
  • Voice usage — voice minute quota progress (e.g. "1% used")
  • Reset available — when the weekly quota resets

What's Missing

There is no SDK method or REST endpoint that exposes these metrics. The Management API (https://management-api.x.ai) only covers team prepaid billing / pay-as-you-go spend tracking. Grok Build uses a subscription-based quota system that is tracked separately.

Proposed Additions

We'd love to see the SDK support for:

  1. Grok Build quota — current usage % and reset time

    # Example of desired API surface:
    client.quota.get_grok_build()  # → {used_percent: 2.0, reset: "2026-08-23T00:00:00Z"}
  2. Voice usage quota — current voice usage % and reset time

    client.quota.get_voice_usage()  # → {used_percent: 1.0, reset: "2026-08-23T00:00:00Z"}
  3. Account-level quota summary — all plan limits in one call

    client.quota.get_summary()  # → {build: {...}, voice: {...}, ...}

Why This Matters

  • Third-party tools (like usage dashboards) can't aggregate xAI usage with other providers
  • Developers building on Grok Build can't show users their own quota limits
  • No way to programmatically check if quota is near exhaustion

References

Thanks for considering!

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions