Organization Roles

Transfer business ownership

This cannot be undone from this call. The target accepted member becomes the owner and the caller's own role is demoted to manager, in one transaction, so there is never a two-owner or zero-owner window. Only an owner of the business may call this. The target role must be accepted with a user attached, must not already be an owner, and must not be the caller's own role.

post/organization-roles/{organization_role_id}/transfer-ownership

Request

  • Base URL: https://api.purplegrain.com/api/v1
  • URL: https://api.purplegrain.com/api/v1/organization-roles/{organization_role_id}/transfer-ownership
  • Auth: HTTP bearer

Path parameters

organization_role_idstring required

Id of the target organization role (the new owner's role)

Response

Ownership transferred — the updated target role.

Example response

{
  "data": {
    "type": "organization_role"
  }
}

Changes

No recorded changes to this operation across all 4 revisions of this API.