Obtener conexiones

Referencia de la API para enumerar las conexiones de Integration Service en una carpeta, con la URL del punto final, los encabezados necesarios y la respuesta de ejemplo.

Recupera las conexiones en una carpeta.

Punto final de API

GET BaseURL/v1/Connections

• Utiliza la URL base de la API de conexiones para la plataforma en la nube en la que te encuentras.

Solicitar encabezados.

Encabezado	Valor
Autorización	Portador <your-access-token>
X-UIPATH-IdDeCuenta	<tenant>
X-UIPATH-ClaveDeCarpeta	La clave de la carpeta que contiene las conexiones

Reemplaza todos los valores entre corchetes angulares <...> con sus valores de caso de uso correspondientes.

El <your-access-token> es el que recibiste al autorizar la aplicación externa. Está disponible durante 1 hora, luego debes generar uno nuevo o solicitar un token de actualización. Consulta Acceso a la API para saber cómo registrar una aplicación externa y obtener este token.

Importante:

Las aplicaciones externas deben dirigirse a una sola carpeta, identificada por el encabezado X-UIPATH-FolderKey . Una solicitud que omite el encabezado, o que establece allFolders como true, devuelve 400 Bad Request.

Parámetros de consulta

Parámetro de consulta	Tipo de datos	Descripción	Valor predeterminado
Todas las carpetas	boolean	No es compatible con aplicaciones externas. Establecerlo en true devuelve 400 Bad Request.	false

Respuesta

200 OK

Devuelve las conexiones en la carpeta solicitada. Las respuestas a una aplicación externa excluyen el propietario de la conexión, el ID de instancia del elemento, el intervalo de sondeo y la marca Trae tu propia aplicación.

[
  {
    "Id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "Name": "My Salesforce connection",
    "Connector": {
      "Key": "uipath-salesforce-sfdc",
      "Name": "Salesforce"
    },
    "Folder": {
      "Key": "3fa85f64-5717-4562-b3fc-2c963f66afa6"
    },
    "State": "Connected",
    "IsDefault": true,
    "CreateTime": "2026-09-10T10:20:24.485Z",
    "UpdateTime": "2026-09-10T10:20:24.485Z"
  }
]

400 Bad Request

La solicitud no proporcionó el encabezado X-UIPATH-FolderKey o estableció allFolders en true. Las aplicaciones externas deben dirigirse a una carpeta por solicitud.

401 No autorizado

Falta el token de acceso, ha caducado o no es válido.

403 Forbidden

La aplicación externa no tiene el ámbito necesario o no tiene permiso Connections.View en la carpeta solicitada.