Update User

Ponto de extremidade da API para atualizar o nome, a associação de grupo e outras propriedades de um usuário local especificado no Test Cloud.

Atualiza as informações sobre o usuário local especificado.

Observação:

Não é possível alterar o endereço de email de um usuário. Se um endereço de e-mail de um usuário precisar ser alterado (por exemplo, devido a uma alteração de domínio de uma empresa), convide o usuário usando seu novo endereço de e-mail e, em seguida, exclua a conta associada ao endereço antigo.

Ponto de Extremidade da API

PUT {accessURL}/{organizationName}/identity_/api/User/{userId}

Substitua {accessURL} em todos os caminhos do ponto de extremidade pelo URL base para sua plataforma de nuvem:

Cloud Platform	URL de acesso
Test Cloud	https://cloud.uipath.com/
Test Cloud para o Setor Público	https://govcloud.uipath.us/
Test Cloud Dedicado	https://{customURL}.dedicated.uipath.com/

Escopos

Requer os seguintes escopos:

• PM.User
• PM.User.Write

Cabeçalhos de solicitação.

--header 'Authorization: Bearer <your-access-token>'\
--header 'Content-Type: application/json'

Observação:

Para obter o <your-access-token>, certifique-se de se autenticar por meio de um dos métodos descritos aqui.

Parâmetros do caminho

Parâm	Tipo de dados	Description
userId (obrigatório)	String	A ID do usuário que você deseja atualizar.

Corpo da Solicitação

O corpo da solicitação contém informações do usuário que você deseja atualizar, como nome, email ou associação a grupos.

{
  "name": "string",
  "surname": "string",
  "email": "[e-mail]",
  "isActive": true,
  "password": "string",
  "groupIDsToAdd": [
    "string"
  ],
  "groupIDsToRemove": [
    "string"
  ],
  "bypassBasicAuthRestriction": true,
  "invitationAccepted": true
}

Resposta

200 OK

O grupo personalizado é atualizado com as informações que você forneceu.

400 Bad Request

Não foi possível executar a atualização.

{
    "errors": {
        "bypassBasicAuthRestriction": [
            "Unexpected character encountered while parsing value: h. Path 'bypassBasicAuthRestriction', line 17, position 35.",
            "Unexpected character encountered while parsing value: a. Path 'bypassBasicAuthRestriction', line 17, position 35."
        ]
    },
    "type": "https://tools.ietf.org/html/rfc7231#section-6.5.1",
    "title": "One or more validation errors occurred.",
    "status": 400,
    "traceId": "00-aec3de9099a9934e9c31e26c19f5e0dd-8c0d3d5f476c7742-00"
}

Exemplo de solicitação

Digamos que você reuniu todas as informações necessárias para criar a chamada de API.

• Seu {baseURL} é: https://cloud.uipath.com/{organizationName}/identity_
• Seu <your-access-token> é: 1234 (para considerações de comprimento).
• Você deseja atualizar as informações e associações da ID do usuário her-1909.

A chamada deve ser semelhante ao seguinte exemplo (cURL):

curl --location --request PUT 'https://cloud.uipath.com/{organizationName}/identity_/api/User/her-1909' \
--header 'Authorization: Bearer 1234' \
--header 'Content-Type: application/json'
--data-raw '{
    "name": "Hermione",
    "surname": "Granger-Weasley",
    "email": "[e-mail]",
    "groupIDsToAdd": [
        "gryff-01",
        "alumni-02",
        "teachers-03"
    ],
    "groupIDsToRemove": [],
    "bypassBasicAuthRestriction": false
}'

Aqui está a resposta de uma chamada bem-sucedida:

{
    "succeeded": true,
    "errors": []
}