Meta
Copy Page
Handwrite
Handwrite Regular Accounts
Start here — Handwrite for outside developers
API specification notes
Socket specification notes
Account
README — GET /api/v1/me
README — DELETE /api/v1/me
README — GET /api/v1/me/policy
README — GET /api/v1/me/usage
Account API — README
Who this credential acts for
Delete the account (after a 30-day grace period)
What your teams' and classes' policies allow
Your own usage, and what your teams and classes counted
Documents
README — GET /api/v1/documents
README — POST /api/v1/documents
README — GET /api/v1/documents/search
README — GET /api/v1/documents/{id}
README — PATCH /api/v1/documents/{id}
README — DELETE /api/v1/documents/{id}
README — GET /api/v1/documents/{id}/content
README — PUT /api/v1/documents/{id}/content
README — POST /api/v1/documents/{id}/live
README — GET /api/v1/export
Documents API — README
List your documents (or shared, or changes since)
Create a document
Search your own and shared documents
A document's metadata
Change title, text, content type or language
Delete a document (owner)
The document's text
Replace the text
Join the document's live co-editing room
Every document you own, with its text
Files
README — GET /api/v1/documents/{id}/file
README — POST /api/v1/documents/{id}/file
README — POST /api/v1/documents/{id}/file/commit
README — POST /api/v1/documents/{id}/extract
Files API — README
Download the original file
Start uploading the original file
Make an uploaded file the document's file
Replace the text with the file's text
Audio
README — GET /api/v1/documents/{id}/audio
README — POST /api/v1/audio/stream
README — POST /api/v1/audio/speech
README — GET /api/v1/voices
README — GET /api/v1/quota
Audio API — README
The whole document as one audio file
Stream speech as it's made
Speech with word timings (read-along)
Voices you can use
Characters left, limit, plan and reset time
Sharing
README — GET /api/v1/documents/{id}/permissions
README — POST /api/v1/documents/{id}/permissions
README — PATCH /api/v1/documents/{id}/permissions/{principal}
README — DELETE /api/v1/documents/{id}/permissions/{principal}
README — DELETE /api/v1/documents/{id}/invitations/{inviteId}
README — GET /api/v1/invitations
README — POST /api/v1/invitations/{id}/accept
README — POST /api/v1/invitations/{id}/decline
Sharing API — README
Who a document is shared with
Share by principal, or invite by email (owner)
Change someone's role (owner)
Remove access (owner, or leave yourself)
Cancel a pending invitation (owner)
Document invitations to your verified email
Accept a document invitation
Decline a document invitation
Settings
README — GET /api/v1/settings
README — PATCH /api/v1/settings
Settings API — README
Synced app and reader settings
Change settings (per key, the newer updatedAt wins)
Webhooks
Incoming webhook delivery — README
README — GET /api/v1/webhooks
README — POST /api/v1/webhooks
README — GET /api/v1/webhooks/{id}
README — DELETE /api/v1/webhooks/{id}
Webhooks API — README
Your webhook endpoints
Register an endpoint (up to 10)
One endpoint
Delete an endpoint (queued retries are dropped)
Meta
README — GET /api/v1/openapi.json
Meta API — README
This OpenAPI description
GET
OAuth
README — POST /api/oauth/token
README — POST /api/oauth/revoke
OAuth API — README
Exchange a code, or refresh
Revoke a token (RFC 7009)
Live socket
Live document socket — README
A document or sharing event
Meta
Copy Page
Meta API — README
This description.
This section is for regular-account integrations. Start with the application guide and API specification notes, then open the README paired with each operation below.
Method
Path
Purpose
GET
/api/v1/openapi.json
This OpenAPI description
Modified at
2026-10-26 13:03:05
Previous
README — GET /api/v1/openapi.json
Next
This OpenAPI description