v11

latestOpenAPI 3.1.12026-08-03174162.0 MB

Team Members

Transfer team ownership

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

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

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"
      ]
    }
  ]
}