automation-cloud

latest

false

Importante :

Este contenido se ha localizado parcialmente a partir de un sistema de traducción automática. La localización de contenidos recién publicados puede tardar entre una y dos semanas en estar disponible.

Guía de la API de UiPath Automation Cloud

Última actualización 9 de oct. de 2025

Crear una nueva cuenta de robot

Crea una nueva cuenta UiPath Robot en el ID de organización especificado y la asigna a los grupos indicados.

Punto final de API

POST https://cloud.uipath.com/{organizationName}/identity_/api/RobotAccount

Ámbitos

Necesita los siguientes ámbitos:

PM.RobotAccount
PM.RobotAccount.Write

Solicitar encabezados.

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

Nota: para obtener el {access_token}, asegúrate de autenticar a través de uno de los métodos descritos aquí.

Solicitar cuerpo

El cuerpo de la solicitud contiene el ID de la organización a la que quieres añadir el grupo y, de manera opcional, los usuarios que quieres añadir como miembros en el nuevo grupo.

{
  "partitionGlobalId": "string",
  "id": "string",
  "name": "string",
  "groupIDsToAdd": [
    "string", "string"
  ]
}{
  "partitionGlobalId": "string",
  "id": "string",
  "name": "string",
  "groupIDsToAdd": [
    "string", "string"
  ]
}

Respuesta

201 Successful

El grupo personalizado se crea en el organización indicado y obtiene un ID.

Solicitud de ejemplo

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

Su {baseURL} es: https://cloud.uipath.com/{organizationName}/identity_
Tu {access_token} es: 1234 (para consideraciones de longitud)
El {partitionGlobalId} es: 3fa85f64-5717-4562-b3fc-2c963f66afa6
Si quieres nombrar el grupo: "Gryffindors"
Quieres añadir a los usuarios Ron, Harry y Hermione al grupo. Estos usuarios tienen los siguientes ID de usuario:
- Ron utiliza el identificador ron-0103
- Identificador de Harry usuario: har-3107
- El identificador de usuario de Hermione es her-1909

La llamada debe parecerse al siguiente ejemplo (cURL):

curl --location --request POST 'https://cloud.uipath.com/{organizationName}/identity_/api/Group' \
--header 'Authorization: Bearer 1234' \
--header 'Content-Type: application/json'
--data-raw '{
    "name": "Roby",
    "displayName": "Roby",
    "partitionGlobalId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "groupIDsToAdd": [
        "gryff-01"
    ],
    "groupIDsToRemove": []
}'curl --location --request POST 'https://cloud.uipath.com/{organizationName}/identity_/api/Group' \
--header 'Authorization: Bearer 1234' \
--header 'Content-Type: application/json'
--data-raw '{
    "name": "Roby",
    "displayName": "Roby",
    "partitionGlobalId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "groupIDsToAdd": [
        "gryff-01"
    ],
    "groupIDsToRemove": []
}'

Esta es la respuesta para una llamada exitosa:

{
    "id": "rb-12",
    "name": "Roby",
    "displayName": "Roby",
    "creationTime": "2021-10-20T15:20:29.1302044Z",
    "lastLoginTime": null,
    "groupIds": ["gryff-01"]
}{
    "id": "rb-12",
    "name": "Roby",
    "displayName": "Roby",
    "creationTime": "2021-10-20T15:20:29.1302044Z",
    "lastLoginTime": null,
    "groupIds": ["gryff-01"]
}