Delete with its memberships, invitations, documents and shares (owner)

DELETE

/api/v1/orgs/{id}

Team authority: The actual owning user principal (org.delete); an admin-level organisation token is not the owner.

App integration: Deletes team-owned documents, memberships, invitations and grants to the team, along with its organisation data. This is destructive and is not the same as leaving or disconnecting OAuth. Require an explicit owner decision in your app.

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

Deleted.

Headers

This response does not have a body.

🟠401Unauthorized

🟠403Forbidden

🟠404NotFound

🟠429TooManyRequests

🔴500ServerError

Request Example

Shell

JavaScript

Java

Swift

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

Response Example

401 - Example 1

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

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

Rename a team (owner or admin)

README — GET /api/v1/orgs/invitations