Update a team member's tenant access

This endpoint can be used to update existing tenant roles.

PATCH https://{teamSlug}.teams.auth0.com/api/members/{id}/tenants

Update a team member's tenant access

cURL

curl --request PATCH \
  --url https://{teamSlug}.teams.auth0.com/api/members/{id}/tenants \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "tenants": [
    "3c90c3cc-0d44-4b50-8888-8dd25736052a"
  ],
  "roles": [],
  "client_ids": [
    "<string>"
  ]
}
'

200

{
  "status_code": 123,
  "message": "<string>",
  "summary": {
    "total_count": 123,
    "success_count": 123,
    "failure_count": 123
  },
  "success": [
    {
      "tenant_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "roles": [],
      "client_ids": [
        "<string>"
      ]
    }
  ],
  "failure": [
    {
      "tenant_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "status": 123,
      "title": "<string>",
      "type": "<string>"
    }
  ]
}

Authorizations

Authorization · string · header · required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

id · string · required

The unique ID of the team member to update

Body

application/json

The tenants and roles to update for the team member.

tenants · string<uuid>[] · required

A list of tenant ids

Required array length: 1 - 10 elements

Unique identifier of the tenant

roles · enum<string>[] · required

List of roles to be assigned to the tenant member

Tenant Member Role

Available options: owner, editor-connections, editor-users, editor-specific-apps, editor-organizations, viewer-config, viewer-users, support-access, elevated-support-access, editor-kms

client_ids · string[]

List of applications. Only if nested role is editor-specific-app

Required string length: 5 - 50

Pattern: ^([0-9a-zA-Z-_@\.~]{5,64})$

Response

200

application/json

Operation completed with errors

status_code · integer · required

Status code for partial response

message · string · required

Describing the partial error scenario

summary · object · required

Summary of the bulk tenant operation

Show child attributes

success · object[] · required

List of successful instances

Show child attributes

failure · object[] · required

List of failed instances

Show child attributes