- Handwrite Regular Accounts
- Schemas
- Error
- Principal
- Role
- Access
- ContentType
- Language
- FileRef
- Document
- Tombstone
- DocumentPage
- CreateDocument
- UpdateDocument
- FileInfo
- CommitUpload
- Upload
- DownloadLink
- Extracted
- ExtractionFailed
- CommittedDocument
- ExtractedDocument
- SearchHit
- SearchPage
- Export
- Permission
- Share
- ChangeRole
- Invitation
- Permissions
- ReceivedInvitation
- AcceptedInvitation
- Me
- WebhookEventType
- Webhook
- CreateWebhook
- CreatedWebhook
- WebhookDelivery
- AudioFormat
- Speech
- WordTiming
- SpeechMarks
- AudioLink
- Voice
- Quota
- SettingEntry
- Settings
- SettingsPatch
- PatchedSettings
- OAuthToken
- OAuthError
- Schemas
- Handwrite Team
- Handwrite Classroom
- Handwrite Admin
- Start here — staff console
- Admin API specification notes
- Admin socket specification notes
- Staff role and permission matrix
- Staff workflows and architecture
- Admin source and validation status
- Customer accounts
- README — GET /api/admin/accounts/{sub}/billing
- README — GET /api/admin/accounts/{sub}/cloud/documents/{id}
- README — GET /api/admin/accounts/{sub}/cloud/documents
- README — POST /api/admin/accounts/{sub}/cloud/keys/{keyId}/revoke
- README — GET /api/admin/accounts/{sub}/cloud/keys
- README — GET /api/admin/accounts/{sub}/cloud/oauth
- README — GET /api/admin/accounts/{sub}/cloud/orgs
- README — GET /api/admin/accounts/{sub}/cloud/settings
- README — GET /api/admin/accounts/{sub}/cloud/usage
- README — GET /api/admin/accounts/{sub}/cloud/webhooks
- README — POST /api/admin/accounts/{sub}/delete
- README — POST /api/admin/accounts/{sub}/disable
- README — POST /api/admin/accounts/{sub}/enable
- README — POST /api/admin/accounts/{sub}/mfa-reset
- README — POST /api/admin/accounts/{sub}/password-reset
- README — POST /api/admin/accounts/{sub}/purge
- README — POST /api/admin/accounts/{sub}/restore
- README — GET /api/admin/accounts/{sub}
- README — PATCH /api/admin/accounts/{sub}
- README — POST /api/admin/accounts/{sub}/sign-out
- README — GET /api/admin/accounts
- GET /api/admin/accounts/{sub}/billing
- GET /api/admin/accounts/{sub}/cloud/documents/{id}
- GET /api/admin/accounts/{sub}/cloud/documents
- POST /api/admin/accounts/{sub}/cloud/keys/{keyId}/revoke
- GET /api/admin/accounts/{sub}/cloud/keys
- GET /api/admin/accounts/{sub}/cloud/oauth
- GET /api/admin/accounts/{sub}/cloud/orgs
- GET /api/admin/accounts/{sub}/cloud/settings
- GET /api/admin/accounts/{sub}/cloud/usage
- GET /api/admin/accounts/{sub}/cloud/webhooks
- POST /api/admin/accounts/{sub}/delete
- POST /api/admin/accounts/{sub}/disable
- POST /api/admin/accounts/{sub}/enable
- POST /api/admin/accounts/{sub}/mfa-reset
- POST /api/admin/accounts/{sub}/password-reset
- POST /api/admin/accounts/{sub}/purge
- POST /api/admin/accounts/{sub}/restore
- GET /api/admin/accounts/{sub}
- PATCH /api/admin/accounts/{sub}
- POST /api/admin/accounts/{sub}/sign-out
- GET /api/admin/accounts
- Staff administration
- README — POST /api/admin/admins/{sub}/password-reset
- README — PATCH /api/admin/admins/{sub}
- README — DELETE /api/admin/admins/{sub}/sessions
- README — GET /api/admin/admins
- README — POST /api/admin/admins
- POST /api/admin/admins/{sub}/password-reset
- PATCH /api/admin/admins/{sub}
- DELETE /api/admin/admins/{sub}/sessions
- GET /api/admin/admins
- POST /api/admin/admins
- Operations
- README — GET /api/admin/alarms
- README — GET /api/admin/audit
- README — GET /api/admin/billing
- README — GET /api/admin/config
- README — PUT /api/admin/config
- README — GET /api/admin/deletions
- README — GET /api/admin/icloud/probe
- README — POST /api/admin/jobs/rollup
- README — GET /api/admin/me
- README — GET /api/admin/overview
- README — GET /api/admin/usage/accounts/{sub}
- README — GET /api/admin/usage/orgs/{id}
- README — GET /api/admin/usage/rollup
- GET /api/admin/alarmsGET
- GET /api/admin/auditGET
- GET /api/admin/billingGET
- GET /api/admin/configGET
- PUT /api/admin/configPUT
- GET /api/admin/deletionsGET
- GET /api/admin/icloud/probeGET
- POST /api/admin/jobs/rollupPOST
- GET /api/admin/meGET
- GET /api/admin/overviewGET
- GET /api/admin/usage/accounts/{sub}GET
- GET /api/admin/usage/orgs/{id}GET
- GET /api/admin/usage/rollupGET
- Authentication
- README — POST /api/admin/auth/challenge
- README — POST /api/admin/auth/sign-in
- README — POST /api/admin/auth/sign-out-all
- README — POST /api/admin/auth/sign-out
- README — POST /api/admin/auth/step-up
- POST /api/admin/auth/challenge
- POST /api/admin/auth/sign-in
- POST /api/admin/auth/sign-out-all
- POST /api/admin/auth/sign-out
- POST /api/admin/auth/step-up
- Staff webhooks
- Organisations
- README — POST /api/admin/orgs/{id}/api-access
- README — GET /api/admin/orgs/{id}/audit
- README — GET /api/admin/orgs/{id}/members
- README — GET /api/admin/orgs/{id}
- README — GET /api/admin/orgs/{id}/usage
- POST /api/admin/orgs/{id}/api-access
- GET /api/admin/orgs/{id}/audit
- GET /api/admin/orgs/{id}/members
- GET /api/admin/orgs/{id}
- GET /api/admin/orgs/{id}/usage
- Schools
- Sessions
- Support
- README — GET /api/admin/support/canned/{id}
- README — PUT /api/admin/support/canned/{id}
- README — DELETE /api/admin/support/canned/{id}
- README — GET /api/admin/support/canned
- README — POST /api/admin/support/canned
- README — GET /api/admin/support/tickets/{id}/attachments/{n}
- README — GET /api/admin/support/tickets/{id}/link
- README — POST /api/admin/support/tickets/{id}/link
- README — POST /api/admin/support/tickets/{id}/note
- README — POST /api/admin/support/tickets/{id}/reply
- README — GET /api/admin/support/tickets/{id}
- README — PATCH /api/admin/support/tickets/{id}
- README — POST /api/admin/support/tickets/{id}/school
- README — POST /api/admin/support/tickets/{id}/spam
- README — GET /api/admin/support/tickets
- GET /api/admin/support/canned/{id}
- PUT /api/admin/support/canned/{id}
- DELETE /api/admin/support/canned/{id}
- GET /api/admin/support/canned
- POST /api/admin/support/canned
- GET /api/admin/support/tickets/{id}/attachments/{n}
- GET /api/admin/support/tickets/{id}/link
- POST /api/admin/support/tickets/{id}/link
- POST /api/admin/support/tickets/{id}/note
- POST /api/admin/support/tickets/{id}/reply
- GET /api/admin/support/tickets/{id}
- PATCH /api/admin/support/tickets/{id}
- POST /api/admin/support/tickets/{id}/school
- POST /api/admin/support/tickets/{id}/spam
- GET /api/admin/support/tickets
- Health
GET /api/admin/usage/orgs/{id}
Developing
GET
/api/admin/usage/orgs/{id}
GET /api/admin/usage/orgs/:id?from&to: the org's ROLLUP#org# days plus its last 48 h of UsageMinute rows (an Index1 query).
Staff cookie session; permission usage.read.
Source snapshot: admin/src/app/api/admin/usage/orgs/[id]/route.ts. This reference describes the current working tree, not proof of deployment. The response service types and validators remain authoritative.
Request
Authorization
API Key
Add parameter in cookie
__Host-hwa_session
Example:
__Host-hwa_session: ********************or
Path Params
Query Params
Responses
🟢200
application/json
GET /api/admin/usage/orgs/:id?from&to: the org's ROLLUP#org# days plus its last 48 h of UsageMinute rows (an Index1 query).
Bodyapplication/json
🟠400
🟠401
🟠403
🟠429
⚪default
Request Request Example
Shell
JavaScript
Java
Swift
curl --location '/api/admin/usage/orgs/?from=&to='Response Response Example
200 - Example 1
{}Modified at 2026-10-26 13:41:16