Replace one member policy override

PUT

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

Classroom integration: PUT replaces the member override. Teachers can manage eligible member overrides; co-teachers can manage only student-tier members. Organisation-only keys such as developerAccess, usageVisibility and exemptAdmins are invalid here. Minors safeguards remain forced, and rules from other memberships may still be stricter.

Required standing: policies.manage, orgs:manage and plan policies feature; co-teacher targets limited to students.

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

Body Params application/jsonRequired

Examples

Responses

🟢200

application/json

The member's policy after the change.

Headers

Bodyapplication/json

🟠400BadRequest

🟠401Unauthorized

🟠403Forbidden

🟠404NotFound

🟠429TooManyRequests

🔴500ServerError

Request Example

Shell

JavaScript

Java

Swift

curl --location --request PUT '/api/v1/orgs//members//policy' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "rules": {
        "property1": {
            "value": "string",
            "locked": true
        },
        "property2": {
            "value": "string",
            "locked": true
        }
    }
}'

Response Example

200 - Example 1

{
    "property1": "string",
    "property2": "string"
}

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

Read one member policy

Clear one member override