Remove a member

Remove a member from the organisation. Cannot remove the primary owner or the last Owner without first transferring ownership.

Requires members:write scope.

Authorization

bearerAuth members:write

AuthorizationBearer <token>

API token from your dashboard.

Format: so_live_... (production) or so_test_... (test mode).

Tokens carry one or more scopes. Request only the scopes your integration needs:

Scope	Grants
`media:read`	List and retrieve files
`media:write`	Upload and delete files
`logs:read`	Read log entries
`logs:write`	Ingest log entries
`cases:read`	Read cases
`cases:write`	Create and update cases
`apps:read`	Read apps
`apps:write`	Submit apps
`usage:read`	Read quota usage
`members:read`	List organisation members
`members:write`	Invite and remove members
`billing:read`	Read billing and subscription info
`tokens:write`	Create and revoke API tokens

In: header

Scope: members:write

orgId*string

Organisation ID (ULID)

userId*string

User ID of the member (the id field from the list response)

curl -X DELETE "https://example.com/orgs/01HZXXXXXXXXXXXXXXXXXXXXX/members/string"

{
  "ok": true
}

{
  "error": {
    "code": "unauthorized",
    "message": "missing or invalid authorization token"
  }
}

{
  "error": {
    "code": "forbidden",
    "message": "token does not have the required scope"
  }
}

{
  "error": {
    "code": "not_found",
    "message": "file not found"
  }
}

{
  "error": {
    "code": "internal",
    "message": "an unexpected error occurred"
  }
}