ZITADEL Docs
APIsCore ResourcesV2Internal Permissions

UpdateAdministrator

Update Administrator

UpdateAdministrator updates the specific administrator role.

Note that any role previously granted to the user and not present in the request will be revoked.

Required permissions depend on the resource type:

  • "iam.member.write" for instance administrators
  • "org.member.write" for organization administrators
  • "project.member.write" for project administrators
  • "project.grant.member.write" for project grant administrators
POST
/zitadel.internal_permission.v2.InternalPermissionService/UpdateAdministrator

Header Parameters

Connect-Protocol-Version*number

Define the version of the Connect protocol

Value in1
Connect-Timeout-Ms?number

Define the timeout, in ms

Request Body

application/json

userId?string

UserID is the ID of the user whose administrator roles should be updated.

resource*|||

Resource is the type of the resource the administrator roles should be granted for.

roles?roles

Roles are the roles that the user should be granted. Note that any role previously granted to the user and not present in the list will be revoked.

[key: string]?never

Response Body

application/json

application/json

curl -X POST "https://loading/zitadel.internal_permission.v2.InternalPermissionService/UpdateAdministrator" \  -H "Connect-Protocol-Version: 1" \  -H "Content-Type: application/json" \  -d '{    "resource": {      "instance": true    }  }'
{
  "changeDate": "1s"
}
{
  "code": "not_found",
  "message": "string",
  "detail": {
    "type": "string",
    "value": "string",
    "debug": {}
  }
}

Was this page helpful?