Returns team credits plus member-limit state for the acting user bound to the API key. Credits are wallet-aware, like GET /credits: teams paying from a linked external wallet report its spendable balance in credit equivalents.
Authorization
bearerAuth usage:readIn: header
Scope: usage:read
Response Body
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/usage"{ "credits": { "totalGranted": 0, "used": 0, "available": 0, "purchaseUrl": "string", "fundingSource": "gimi_wallet", "externalWallet": { "provider": "gimi", "spendableCents": 0, "creditEquivalent": 0 } }, "memberLimit": { "monthlyLimit": 0, "usedThisMonth": 0, "remaining": 0 }, "blocked": { "byTeamLimit": true, "byMemberLimit": true }}{ "error": { "code": "string", "message": "string", "requestId": "string" }}{ "error": { "code": "string", "message": "string", "requestId": "string" }}{ "error": { "code": "string", "message": "string", "requestId": "string" }}Get storage usage GET
Stored bytes and asset counts by type, plus trashed items still held until they are purged. Matches the Storage card on the account usage page. Pass memberId for the assets one member created; another member's storage requires the key's member to be a team owner or admin. Returns usage_breakdown_unavailable (409) until the workspace's storage has been indexed.
Get credit spend breakdown GET
Credit spend over time by model and by source, net of refunds, with runs and gross spent/refunded totals. Matches the Credit Spend card on the account usage page. week, month, and quarter return one bucket per UTC day (the last 7, 30, or 90 days including today); year returns the last 12 calendar months and all returns every month since the first with spend. Omit memberIds for the whole workspace. Summing other members' spend requires the key's member to be a team owner or admin; your own user id is always allowed. source limits the figures to one source and splits it by model when modelsAvailable is true. sessionId limits them to one session (any key may read a session's total); it cannot be combined with memberIds. Returns usage_breakdown_unavailable (409) until the workspace's usage history has been indexed.