# Handwrite Team ## Docs - Root > Teams [README — GET /api/v1/orgs](https://docs.handwrites.io/team/readme-get-apiv1orgs-2496431m0.md): - Root > Teams [README — POST /api/v1/orgs](https://docs.handwrites.io/team/readme-post-apiv1orgs-2496434m0.md): - Root > Teams [README — GET /api/v1/orgs/{id}](https://docs.handwrites.io/team/readme-get-apiv1orgsid-2496446m0.md): - Root > Teams [README — PATCH /api/v1/orgs/{id}](https://docs.handwrites.io/team/readme-patch-apiv1orgsid-2496449m0.md): - Root > Teams [README — DELETE /api/v1/orgs/{id}](https://docs.handwrites.io/team/readme-delete-apiv1orgsid-2496452m0.md): - Root > Membership [README — GET /api/v1/orgs/invitations](https://docs.handwrites.io/team/readme-get-apiv1orgsinvitations-2496437m0.md): - Root > Membership [README — POST /api/v1/orgs/invitations/{inviteId}/accept](https://docs.handwrites.io/team/readme-post-apiv1orgsinvitationsinviteidaccept-2496440m0.md): - Root > Membership [README — POST /api/v1/orgs/invitations/{inviteId}/decline](https://docs.handwrites.io/team/readme-post-apiv1orgsinvitationsinviteiddecline-2496443m0.md): - Root > Membership [README — GET /api/v1/orgs/{id}/members](https://docs.handwrites.io/team/readme-get-apiv1orgsidmembers-2496455m0.md): - Root > Membership [README — POST /api/v1/orgs/{id}/members](https://docs.handwrites.io/team/readme-post-apiv1orgsidmembers-2496458m0.md): - Root > Membership [README — PATCH /api/v1/orgs/{id}/members/{principal}](https://docs.handwrites.io/team/readme-patch-apiv1orgsidmembersprincipal-2496461m0.md): - Root > Membership [README — DELETE /api/v1/orgs/{id}/members/{principal}](https://docs.handwrites.io/team/readme-delete-apiv1orgsidmembersprincipal-2496464m0.md): - Root > Membership [README — POST /api/v1/orgs/{id}/leave](https://docs.handwrites.io/team/readme-post-apiv1orgsidleave-2496467m0.md): - Root > Membership [README — GET /api/v1/orgs/{id}/invitations](https://docs.handwrites.io/team/readme-get-apiv1orgsidinvitations-2496473m0.md): - Root > Membership [README — POST /api/v1/orgs/{id}/invitations](https://docs.handwrites.io/team/readme-post-apiv1orgsidinvitations-2496476m0.md): - Root > Membership [README — DELETE /api/v1/orgs/{id}/invitations/{inviteId}](https://docs.handwrites.io/team/readme-delete-apiv1orgsidinvitationsinviteid-2496479m0.md): - Root > Documents [README — GET /api/v1/orgs/{id}/documents](https://docs.handwrites.io/team/readme-get-apiv1orgsiddocuments-2496470m0.md): - Root > Billing and usage [README — GET /api/v1/orgs/{id}/billing](https://docs.handwrites.io/team/readme-get-apiv1orgsidbilling-2496482m0.md): - Root > Billing and usage [README — GET /api/v1/orgs/{id}/usage](https://docs.handwrites.io/team/readme-get-apiv1orgsidusage-2496510m0.md): - Root > Billing and usage [README — GET /api/v1/orgs/{id}/usage/live](https://docs.handwrites.io/team/readme-get-apiv1orgsidusagelive-2496513m0.md): - Root > Billing and usage [README — GET /api/v1/orgs/{id}/members/{principal}/usage](https://docs.handwrites.io/team/readme-get-apiv1orgsidmembersprincipalusage-2496516m0.md): - Root > Billing and usage [README — GET /api/v1/orgs/{id}/insights](https://docs.handwrites.io/team/readme-get-apiv1orgsidinsights-2496519m0.md): - Root > Policies [README — GET /api/v1/orgs/{id}/policies](https://docs.handwrites.io/team/readme-get-apiv1orgsidpolicies-2496485m0.md): - Root > Policies [README — PUT /api/v1/orgs/{id}/policies](https://docs.handwrites.io/team/readme-put-apiv1orgsidpolicies-2496488m0.md): - Root > Policies [README — GET /api/v1/orgs/{id}/members/{principal}/policy](https://docs.handwrites.io/team/readme-get-apiv1orgsidmembersprincipalpolicy-2496491m0.md): - Root > Policies [README — PUT /api/v1/orgs/{id}/members/{principal}/policy](https://docs.handwrites.io/team/readme-put-apiv1orgsidmembersprincipalpolicy-2496494m0.md): - Root > Policies [README — DELETE /api/v1/orgs/{id}/members/{principal}/policy](https://docs.handwrites.io/team/readme-delete-apiv1orgsidmembersprincipalpolicy-2496497m0.md): - Root > Managed tokens [README — GET /api/v1/orgs/{id}/members/{principal}/tokens](https://docs.handwrites.io/team/readme-get-apiv1orgsidmembersprincipaltokens-2496500m0.md): - Root > Managed tokens [README — POST /api/v1/orgs/{id}/members/{principal}/tokens](https://docs.handwrites.io/team/readme-post-apiv1orgsidmembersprincipaltokens-2496503m0.md): - Root > Managed tokens [README — DELETE /api/v1/orgs/{id}/members/{principal}/tokens/{tokenId}](https://docs.handwrites.io/team/readme-delete-apiv1orgsidmembersprincipaltokenstokenid-2496506m0.md): - Root > Guides [Start here — Team app integration](https://docs.handwrites.io/team/start-here-team-app-integration-2496402m0.md): - Root > Guides [Team API specification notes](https://docs.handwrites.io/team/team-api-specification-notes-2496404m0.md): - Root > Guides [Team socket specification notes](https://docs.handwrites.io/team/team-socket-specification-notes-2496407m0.md): - Root > Guides [Team live socket — README](https://docs.handwrites.io/team/team-live-socket-readme-2496410m0.md): - Root > Guides [Team roles and access model](https://docs.handwrites.io/team/team-roles-and-access-model-2496413m0.md): - Root > Guides [Team credentials and developer setup](https://docs.handwrites.io/team/team-credentials-and-developer-setup-2496416m0.md): - Root > Guides [Team SSO and portal workflows](https://docs.handwrites.io/team/team-sso-and-portal-workflows-2496419m0.md): - Root > Guides [Team policies, plans and seats](https://docs.handwrites.io/team/team-policies-plans-and-seats-2496422m0.md): - Root > Guides [Team usage and collaboration insights](https://docs.handwrites.io/team/team-usage-and-collaboration-insights-2496425m0.md): - Root > Guides [Team webhook delivery — README](https://docs.handwrites.io/team/team-webhook-delivery-readme-2496428m0.md): ## API Docs - Root > Teams [Your teams and classes](https://docs.handwrites.io/team/your-teams-and-classes-45899848e0.md): Team authority: Any authenticated caller with this scope; results reflect current membership. - Root > Teams [Create a team or class](https://docs.handwrites.io/team/create-a-team-or-class-45899849e0.md): Team authority: A person (user: principal), not an organisation or isolated app identity. - Root > Teams [One of your organisations](https://docs.handwrites.io/team/one-of-your-organisations-45899850e0.md): Team authority: A current member; non-members receive 404. - Root > Teams [Rename a team (owner or admin)](https://docs.handwrites.io/team/rename-a-team-owner-or-admin-45899851e0.md): Team authority: Team owner or admin (org.rename). - Root > Teams [Delete with its memberships, invitations, documents and shares (owner)](https://docs.handwrites.io/team/delete-with-its-memberships-invitations-documents-and-shares-owner-45899852e0.md): Team authority: The actual owning user principal (org.delete); an admin-level organisation token is not the owner. - Root > Membership [Organisation invitations to your verified email](https://docs.handwrites.io/team/organisation-invitations-to-your-verified-email-45899853e0.md): Team authority: A person with a matching verified account email. - Root > Membership [Join with the invited role](https://docs.handwrites.io/team/join-with-the-invited-role-45899854e0.md): Team authority: A person whose verified email matches the invitation. - Root > Membership [Decline an organisation invitation](https://docs.handwrites.io/team/decline-an-organisation-invitation-45899855e0.md): Team authority: A person whose verified email matches the invitation. - Root > Membership [Members (students see teachers and themselves)](https://docs.handwrites.io/team/members-students-see-teachers-and-themselves-45899856e0.md): Team authority: Any current member; email visibility depends on role. - Root > Membership [Add a person (managers)](https://docs.handwrites.io/team/add-a-person-managers-45899857e0.md): Team authority: Owner/admin can assign non-owner team roles; managers can add members only. - Root > Membership [Change a role; owner transfers a team](https://docs.handwrites.io/team/change-a-role-owner-transfers-a-team-45899858e0.md): Team authority: Owner/admin may change eligible non-owner roles; managers only manage member-tier targets. Only the owner can transfer ownership. - Root > Membership [Remove a member (managers) or yourself](https://docs.handwrites.io/team/remove-a-member-managers-or-yourself-45899859e0.md): Team authority: Owner/admin or an allowed manager target; any non-owner may remove themselves. - Root > Membership [Leave (not the owner)](https://docs.handwrites.io/team/leave-not-the-owner-45899860e0.md): Team authority: A current non-owner person leaving their own membership. - Root > Membership [Pending email invitations (managers)](https://docs.handwrites.io/team/pending-email-invitations-managers-45899861e0.md): Team authority: Owner/admin or manager through members.manage. - Root > Membership [Invite an email (managers)](https://docs.handwrites.io/team/invite-an-email-managers-45899862e0.md): Team authority: Owner/admin may invite non-owner roles; managers invite members only. - Root > Membership [Withdraw an invitation (managers)](https://docs.handwrites.io/team/withdraw-an-invitation-managers-45899863e0.md): Team authority: Owner/admin or manager through members.manage. - Root > Documents [Documents the organisation owns](https://docs.handwrites.io/team/documents-the-organisation-owns-45899864e0.md): Team authority: A current member with documents:read and any selected-document restrictions. - Root > Billing and usage [Plan, status and seats per role (billing.read)](https://docs.handwrites.io/team/plan-status-and-seats-per-role-billing-read-45899865e0.md): Team authority: Owner/admin or billing (billing.read). - Root > Billing and usage [Usage per day and member (admins, managers, billing)](https://docs.handwrites.io/team/usage-per-day-and-member-admins-managers-billing-45899866e0.md): Needs the usage.read permission; free plans answer 402 plan_required. Teams on usageVisibility orgDocuments (and team managers) see only work on org documents; `hidden` names the counters left at zero. Audited (usage.view). - Root > Billing and usage [The last 60 minutes per member (admins, managers, billing)](https://docs.handwrites.io/team/the-last-60-minutes-per-member-admins-managers-billing-45899867e0.md): Per member: activeNow (anything in the last 2 minutes), lastActiveAt, today's totals and 60 per-minute activity counts. Cached 10 s; poll with If-None-Match for 304s. Audited (usage.view). - Root > Billing and usage [One member's usage (usage.read, or yourself)](https://docs.handwrites.io/team/one-members-usage-usage-read-or-yourself-45899868e0.md): Team authority: A person reading themselves, or owner/admin, manager or billing; applicable plan and visibility checks remain. - Root > Billing and usage [How people collaborate on the org's documents](https://docs.handwrites.io/team/how-people-collaborate-on-the-orgs-documents-45899869e0.md): Admins and managers (insights.read): per document contribution shares, together vs solo minutes, turns, turn-taking ratio and sessions, plus a pair co-editing matrix (document-days, counts only). Members and students: only documents they worked on, with their own share. Never text. Audited (insights.view). - Root > Policies [Org-wide policy rules (policies.read)](https://docs.handwrites.io/team/org-wide-policy-rules-policies-read-45899870e0.md): Team authority: Owner/admin, manager, billing or developer (policies.read). - Root > Policies [Replace the org-wide rules (admins)](https://docs.handwrites.io/team/replace-the-org-wide-rules-admins-45899871e0.md): Team authority: Owner/admin and a plan with policies; managers cannot change organisation-wide rules. - Root > Policies [A member's override and what applies to them](https://docs.handwrites.io/team/a-members-override-and-what-applies-to-them-45899872e0.md): Team authority: Owner/admin, manager, billing or developer (policies.read). The combined public view checks organisation policy authority even when the target is the caller. - Root > Policies [Replace a member's override (admins; managers for members)](https://docs.handwrites.io/team/replace-a-members-override-admins-managers-for-members-45899873e0.md): Team authority: Owner/admin; managers only for member-tier targets; plan with policies. - Root > Policies [Remove a member's override](https://docs.handwrites.io/team/remove-a-members-override-45899874e0.md): Team authority: Same edit permissions and plan gate as setting a member policy. - Root > Managed tokens [Managed tokens issued to a member (tokens.read)](https://docs.handwrites.io/team/managed-tokens-issued-to-a-member-tokens-read-45899875e0.md): Team authority: Owner/admin, manager or billing (tokens.read). - Root > Managed tokens [Issue a managed fine-grained token (admins, billing)](https://docs.handwrites.io/team/issue-a-managed-fine-grained-token-admins-billing-45899876e0.md): Owned by the member, managed by the org: the member sees it read-only and can't change or revoke it. Never orgs:manage. The secret (hwf_…) is returned this once. - Root > Managed tokens [Revoke a managed token (admins, billing)](https://docs.handwrites.io/team/revoke-a-managed-token-admins-billing-45899877e0.md): Team authority: Owner/admin or billing (tokens.manage). ## Schemas - Root [Error](https://docs.handwrites.io/team/error-18478525d0.md): - Root [Principal](https://docs.handwrites.io/team/principal-18478526d0.md): - Root [Role](https://docs.handwrites.io/team/role-18478527d0.md): - Root [Access](https://docs.handwrites.io/team/access-18478528d0.md): - Root [ContentType](https://docs.handwrites.io/team/contenttype-18478529d0.md): - Root [Language](https://docs.handwrites.io/team/language-18478530d0.md): - Root [FileRef](https://docs.handwrites.io/team/fileref-18478531d0.md): - Root [Document](https://docs.handwrites.io/team/document-18478532d0.md): - Root [Tombstone](https://docs.handwrites.io/team/tombstone-18478533d0.md): - Root [DocumentPage](https://docs.handwrites.io/team/documentpage-18478534d0.md): - Root [CreateDocument](https://docs.handwrites.io/team/createdocument-18478535d0.md): - Root [UpdateDocument](https://docs.handwrites.io/team/updatedocument-18478536d0.md): - Root [FileInfo](https://docs.handwrites.io/team/fileinfo-18478537d0.md): - Root [CommitUpload](https://docs.handwrites.io/team/commitupload-18478538d0.md): - Root [Upload](https://docs.handwrites.io/team/upload-18478539d0.md): - Root [DownloadLink](https://docs.handwrites.io/team/downloadlink-18478540d0.md): - Root [Extracted](https://docs.handwrites.io/team/extracted-18478541d0.md): - Root [ExtractionFailed](https://docs.handwrites.io/team/extractionfailed-18478542d0.md): - Root [CommittedDocument](https://docs.handwrites.io/team/committeddocument-18478543d0.md): - Root [ExtractedDocument](https://docs.handwrites.io/team/extracteddocument-18478544d0.md): - Root [SearchHit](https://docs.handwrites.io/team/searchhit-18478545d0.md): - Root [SearchPage](https://docs.handwrites.io/team/searchpage-18478546d0.md): - Root [Export](https://docs.handwrites.io/team/export-18478547d0.md): - Root [Permission](https://docs.handwrites.io/team/permission-18478548d0.md): - Root [Share](https://docs.handwrites.io/team/share-18478549d0.md): - Root [ChangeRole](https://docs.handwrites.io/team/changerole-18478550d0.md): - Root [Invitation](https://docs.handwrites.io/team/invitation-18478551d0.md): - Root [Permissions](https://docs.handwrites.io/team/permissions-18478552d0.md): - Root [ReceivedInvitation](https://docs.handwrites.io/team/receivedinvitation-18478553d0.md): - Root [AcceptedInvitation](https://docs.handwrites.io/team/acceptedinvitation-18478554d0.md): - Root [Me](https://docs.handwrites.io/team/me-18478555d0.md): - Root [WebhookEventType](https://docs.handwrites.io/team/webhookeventtype-18478556d0.md): - Root [Webhook](https://docs.handwrites.io/team/webhook-18478557d0.md): - Root [CreateWebhook](https://docs.handwrites.io/team/createwebhook-18478558d0.md): - Root [CreatedWebhook](https://docs.handwrites.io/team/createdwebhook-18478559d0.md): - Root [WebhookDelivery](https://docs.handwrites.io/team/webhookdelivery-18478560d0.md): - Root [AudioFormat](https://docs.handwrites.io/team/audioformat-18478561d0.md): - Root [Speech](https://docs.handwrites.io/team/speech-18478562d0.md): - Root [WordTiming](https://docs.handwrites.io/team/wordtiming-18478563d0.md): - Root [SpeechMarks](https://docs.handwrites.io/team/speechmarks-18478564d0.md): - Root [AudioLink](https://docs.handwrites.io/team/audiolink-18478565d0.md): - Root [Voice](https://docs.handwrites.io/team/voice-18478566d0.md): - Root [Quota](https://docs.handwrites.io/team/quota-18478567d0.md): - Root [SettingEntry](https://docs.handwrites.io/team/settingentry-18478568d0.md): - Root [Settings](https://docs.handwrites.io/team/settings-18478569d0.md): - Root [SettingsPatch](https://docs.handwrites.io/team/settingspatch-18478570d0.md): - Root [PatchedSettings](https://docs.handwrites.io/team/patchedsettings-18478571d0.md): - Root [OAuthToken](https://docs.handwrites.io/team/oauthtoken-18478572d0.md): - Root [OAuthError](https://docs.handwrites.io/team/oautherror-18478573d0.md): - Root [Error](https://docs.handwrites.io/team/error-18478637d0.md): - Root [Principal](https://docs.handwrites.io/team/principal-18478638d0.md): - Root [Access](https://docs.handwrites.io/team/access-18478639d0.md): - Root [ContentType](https://docs.handwrites.io/team/contenttype-18478640d0.md): - Root [Language](https://docs.handwrites.io/team/language-18478641d0.md): - Root [FileRef](https://docs.handwrites.io/team/fileref-18478642d0.md): - Root [Document](https://docs.handwrites.io/team/document-18478643d0.md): - Root [Tombstone](https://docs.handwrites.io/team/tombstone-18478644d0.md): - Root [DocumentPage](https://docs.handwrites.io/team/documentpage-18478645d0.md): - Root [OrgKind](https://docs.handwrites.io/team/orgkind-18478646d0.md): - Root [OrgRole](https://docs.handwrites.io/team/orgrole-18478647d0.md): - Root [Organisation](https://docs.handwrites.io/team/organisation-18478648d0.md): - Root [CreateOrganisation](https://docs.handwrites.io/team/createorganisation-18478649d0.md): - Root [RenameOrganisation](https://docs.handwrites.io/team/renameorganisation-18478650d0.md): - Root [Member](https://docs.handwrites.io/team/member-18478651d0.md): - Root [AddMember](https://docs.handwrites.io/team/addmember-18478652d0.md): - Root [ChangeMember](https://docs.handwrites.io/team/changemember-18478653d0.md): - Root [InviteMember](https://docs.handwrites.io/team/invitemember-18478654d0.md): - Root [OrgInvitation](https://docs.handwrites.io/team/orginvitation-18478655d0.md): - Root [ReceivedOrgInvitation](https://docs.handwrites.io/team/receivedorginvitation-18478656d0.md): - Root [Error](https://docs.handwrites.io/team/error-18478657d0.md): - Root [Principal](https://docs.handwrites.io/team/principal-18478658d0.md): - Root [Access](https://docs.handwrites.io/team/access-18478659d0.md): - Root [ContentType](https://docs.handwrites.io/team/contenttype-18478660d0.md): - Root [Language](https://docs.handwrites.io/team/language-18478661d0.md): - Root [FileRef](https://docs.handwrites.io/team/fileref-18478662d0.md): - Root [Document](https://docs.handwrites.io/team/document-18478663d0.md): - Root [Tombstone](https://docs.handwrites.io/team/tombstone-18478664d0.md): - Root [DocumentPage](https://docs.handwrites.io/team/documentpage-18478665d0.md): - Root [OrgKind](https://docs.handwrites.io/team/orgkind-18478666d0.md): - Root [OrgRole](https://docs.handwrites.io/team/orgrole-18478667d0.md): - Root [Organisation](https://docs.handwrites.io/team/organisation-18478668d0.md): - Root [CreateOrganisation](https://docs.handwrites.io/team/createorganisation-18478669d0.md): - Root [RenameOrganisation](https://docs.handwrites.io/team/renameorganisation-18478670d0.md): - Root [Member](https://docs.handwrites.io/team/member-18478671d0.md): - Root [AddMember](https://docs.handwrites.io/team/addmember-18478672d0.md): - Root [ChangeMember](https://docs.handwrites.io/team/changemember-18478673d0.md): - Root [InviteMember](https://docs.handwrites.io/team/invitemember-18478674d0.md): - Root [OrgInvitation](https://docs.handwrites.io/team/orginvitation-18478675d0.md): - Root [ReceivedOrgInvitation](https://docs.handwrites.io/team/receivedorginvitation-18478676d0.md):