Accept a class invitation

POST

/api/v1/orgs/invitations/{inviteId}/accept

Classroom integration: The service checks the invitation against the caller verified email, expiry, role and available seat. A teacher invitation created when a school is approved can attach the approved school to its intended admin. Acceptance is a deliberate account action, not an automatic consequence of connecting an integration.

Required standing: Matching verified human customer identity with orgs:manage.

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

OAuth 2.0

Authorization Code

Add the parameter

Authorization

to Headers，whose value is to concatenate the Token after the Bearer.

Example:

Authorization: Bearer ********************

Authorize URL: https://handwrites.io/oauth/authorize

Token URL: https://handwrites.io/api/oauth/token

Refresh URL: https://handwrites.io/api/oauth/token

Scopes:

orgs:manage-Create, rename and delete teams and classrooms, manage members and invitations, join and leave

Path Params

Responses

🟢200

application/json

The organisation.

Headers

Bodyapplication/json

🟠401Unauthorized

🟠403Forbidden

🟠404NotFound

🟠409Conflict

🟠422Unprocessable

🟠429TooManyRequests

🔴500ServerError

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST '/api/v1/orgs/invitations//accept' \
--header 'Authorization: Bearer <token>'

Response Example

200 - Example 1

{
    "id": "string",
    "kind": "team",
    "principal": "user:3f2b…",
    "name": "string",
    "owner": "user:3f2b…",
    "role": "owner",
    "createdAt": "2019-08-24T14:15:22.123Z",
    "updatedAt": "2019-08-24T14:15:22.123Z"
}

Modified at 2026-10-26 13:12:44

Read invitations to the signed-in person

Decline a class invitation