Remove an ordinary class membership

DELETE

/api/v1/orgs/{id}/members/{principal}

Classroom integration: Teachers can remove eligible members; co-teachers can remove student-tier members; a non-owner can remove themselves where permitted. The owning teacher cannot be removed. A staff-provisioned school student must be removed through Students so their managed account and data are erased together; this public route refuses that removal.

Required standing: members.manage for other people, or self; orgs:manage remains required. School student and owner protections still apply.

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

🟢204

Removed.

Headers

This response does not have a body.

🟠400BadRequest

🟠401Unauthorized

🟠403Forbidden

🟠404NotFound

🟠429TooManyRequests

🔴500ServerError

Request Example

Shell

JavaScript

Java

Swift

curl --location --request DELETE '/api/v1/orgs//members/' \
--header 'Authorization: Bearer <token>'

Response Example

400 - Example 1

{
    "error": {
        "code": "string",
        "message": "string"
    }
}

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

Change a class member role

Leave an ordinary class