Skip to content
OpenPostDocs
OpenPostDocs
Workspaces

Nominate a successor Organization Owner

Requires the current Owner, an unscoped browser session, exact Organization-name confirmation, and recent reauthentication. Authority changes only after acceptance.

POST/organizations/{id}/ownership-transfer

Authorization

bearerAuth
AuthorizationBearer <token>

In: header

Path Parameters

id*string

Organization ID

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

curl -X POST "https://example.com/organizations/string/ownership-transfer" \  -H "Content-Type: application/json" \  -d '{    "confirm_organization_name": "string",    "nominee_user_id": "string",    "reauth_grant": "string"  }'
{  "$schema": "https://example.com/api/v1/schemas/OwnershipTransferResponse.json",  "expires_at": "string",  "id": "string",  "nominee_email": "string",  "nominee_user_id": "string",  "organization_id": "string",  "organization_name": "string",  "prior_owner_email": "string",  "prior_owner_user_id": "string",  "status": "pending"}