Replace the org-wide rules (admins)

PUT

/api/v1/orgs/{id}/policies

Team authority: Owner/admin and a plan with policies; managers cannot change organisation-wide rules.

App integration: PUT replaces the complete stored rule map. Read first, edit deliberately and preserve rules the user did not intend to remove. Empty rules returns to defaults, subject to enforced controls. This endpoint cannot lift a staff API suspension.

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 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//policies' \
--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:30

Org-wide policy rules (policies.read)

A member's override and what applies to them