Team Members

Transfer team ownership

Changed on

Make an active team member the sole owner. Team key can be ID or slug. A current team owner or tenant administrator can perform this action. The new owner receives the team Admin role, while previous owners keep their existing access and lose only isOwner status.

post/teams/{key}/transfer

Request

  • Base URL: https://api.session.services
  • URL: https://api.session.services/teams/{key}/transfer
  • Auth: API key in header x-tenant-id

Path parameters

keystring required

Team identifier (ID or slug)

Request body

newOwnerIdstring required

Team member ID of the new owner. This member must already exist with ACTIVE status.

Response

OK

Example response

{
  "previousOwner": {
    "permissions": [
      "event.read",
      "event.write",
      "order.read"
    ]
  },
  "newOwner": {
    "permissions": [
      "event.read",
      "event.write",
      "order.read"
    ]
  },
  "demotedOwners": [
    {
      "permissions": [
        "event.read",
        "event.write",
        "order.read"
      ]
    }
  ]
}

Changes

  • 84f157e4443aRevision changes
    • info

      added the non-success response with the status

    • info

      added the required property to the response with the status