Choose a class from the returned organisations

GET

/api/v1/orgs

Classroom integration: Shows organisations the credential represents. The shared route returns both kinds; filter kind === "class" in your UI rather than sending an undocumented kind filter. Persist the selected org ID independently of account connection. An organisation token represents its own organisation, not every organisation of its creator.

Required standing: Any authenticated caller with the named scope; response is limited to represented organisations.

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:read-List your teams and classrooms and see who is in them

Responses

🟢200

application/json

With your role in each.

Headers

Bodyapplication/json

🟠401Unauthorized

🟠403Forbidden

🟠429TooManyRequests

🔴500ServerError

Request Example

Shell

JavaScript

Java

Swift

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

Response Example

200 - Example 1

{
    "organisations": [
        {
            "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

Class setup API — README

Create an ordinary class