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

Request

  • Base URL: https://app.openpo.st/api/v1
  • URL: https://app.openpo.st/api/v1/organizations/{id}/ownership-transfer
  • Auth: one of:
    • HTTP bearer
    • API key in cookie openpost_session

Path parameters

idstring required

Organization ID

Request body

$schemastring uri

A URL to the JSON Schema for this object.

confirm_organization_namestring required

Exact Organization name as explicit confirmation

nominee_user_idstring required

Eligible Organization member user ID

reauth_grantstring required

One-time grant for organization.ownership.transfer

Example request

{
  "$schema": "https://example.com/api/v1/schemas/InitiateOwnershipTransferInputBody.json"
}

Response

OK

$schemastring uri

A URL to the JSON Schema for this object.

expires_atstring required
idstring required
nominee_emailstring required
nominee_user_idstring required
organization_idstring required
organization_namestring required
prior_owner_emailstring required
prior_owner_user_idstring required
status'pending' | 'accepted' | 'declined' | 'revoked' | 'expired' required

Example response

{
  "$schema": "https://example.com/api/v1/schemas/OwnershipTransferResponse.json"
}

Changes

No recorded changes to this operation across all 1 revision of this API.