コネクションを取得

フォルダー内の Integration Service のコネクションを、エンドポイント URL、必要なヘッダー、応答の例とともに一覧表示するための API リファレンスです。

フォルダー内のコネクションを取得します。

API エンドポイント

GET BaseURL/v1/Connections

• 使用しているクラウド プラットフォームの Connections API ベース URL を使用します。

要求ヘッダー

ヘッダー	値 (Value)
認可	Bearer <your-access-token>
X-UIPATH-アカウント ID	<tenant>
X-UIPATH-FolderKey	コネクションを保持するフォルダーのキーです

角括弧で囲まれた値 <...> をすべて、対応するユース ケース値に置き換えます。

<your-access-token>は、外部アプリケーションを承認したときに受け取ったものです。この機能は 1 時間利用可能なので、新しいプールを生成するか、更新トークンをリクエストする必要があります。外部アプリケーションを登録してトークンを取得する方法については、「 API アクセス 」をご覧ください。

重要:

外部アプリケーションの対象は、 X-UIPATH-FolderKey ヘッダーで識別される 1 つのフォルダーである必要があります。ヘッダーを省略した要求、または を trueに設定allFolders要求は、 を返400 Bad Request。

クエリ パラメーター

クエリ パラメーター	データ型	説明	既定値
すべてのフォルダー	boolean	外部アプリケーションではサポートされていません。true に設定すると、 400 Bad Requestが返されます。	false

応答

200 OK

要求されたフォルダー内のコネクションを返します。外部アプリケーションへの応答には、コネクションの所有者、要素インスタンス ID、ポーリング間隔、および Bring-your-own-app フラグは含まれません。

[
  {
    "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

要求で X-UIPATH-FolderKey ヘッダーが指定されていないか、 allFolders が に設定され true。外部アプリケーションは、要求ごとに 1 つのフォルダーを対象とする必要があります。

401 未承認

アクセス トークンが見つからないか、期限切れであるか、無効です。

403 Forbidden

外部アプリケーションが必要なスコープを保持していないか、要求されたフォルダーで Connections.View 権限がありません。