Actualizar una cuenta de robot

Punto final de la API para actualizar la información sobre una cuenta de robot especificada en Automation Suite.

Actualiza la información sobre la cuenta de robot especificada.

Punto final de API

PUT https://{yourDomain}/{organizationName}/identity_/api/Setting

Ámbitos

Necesita los siguientes ámbitos:

• PM.RobotAccount
• PM.RobotAccount.Write

Solicitar encabezados.

--header 'Authorization: Bearer {access_token}'\
--header 'Content-Type: application/json'

Nota:

Para obtener el {access_token}, asegúrate de autenticarte a través de uno de los métodos descritos aquí.

Parámetros de ruta

Parámetro	Tipo de datos	Descripción
robotAccountId	Cadena	Requerido. El ID de la cuenta de UiPath Robot que quieres actualizar.

Solicitar cuerpo

El cuerpo de la solicitud contiene el ID de la organización a la que pertenece la cuenta de UiPath Robot y la información que quieres actualizar, como, por ejemplo, la pertenencia a un grupo.

{
  "partitionGlobalId": "string",
  "displayName": "string",
  "groupIDsToAdd": [
    "string"
  ],
  "groupIDsToRemove": [
    "string"
  ]
}

Respuesta

200 OK

El grupo personalizado se actualiza con la información que has proporcionado.

Solicitud de ejemplo

Supongamos que has recopilado toda la información necesaria para crear la llamada a la API.

• Tu {baseURL} es: https://{yourDomain}/{organizationName}/{tenantName}/
• Tu {access_token} es: 1234 (para consideraciones de longitud)
• El {partitionGlobalId} es: magic-7
• Quieres asignar la cuenta de UiPath Robot con ID 88-uv al grupo con ID alumni-02.

La llamada debe parecerse al siguiente ejemplo (cURL):

curl --location --request PUT 'https://{yourDomain}/{organizationName}/{tenantName}/identity_/api/RobotAccount/88-uv' \
--header 'Authorization: Bearer 1234' \
--header 'Content-Type: application/json'
--data-raw '{
    "partitionGlobalId": "magic-7",
    "displayName": "Roby",
    "groupIDsToAdd": [
        "alumni-02"
    ],
    "groupIDsToRemove": []
}'

Esta es la respuesta para una llamada exitosa:

{
    "id": "88-uv",
    "name": "Roby",
    "displayName": "Roby",
    "creationTime": "2021-10-20T12:16:16.6492925",
    "lastLoginTime": null,
    "groupIds": [
        "alumni-02",
        "gryff-01"
    ]
}