ID で接続を取得

単一の Integration Service コネクションを ID で取得するための API リファレンスと、エンドポイント URL、パス パラメーター、応答の例付き

単一の接続を ID で取得します。

API エンドポイント

GET BaseURL/v1/Connections/{connectionId}

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

要求ヘッダー

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

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

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

重要:

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

Path 変数

Path 変数	データ型	説明	既定値
connectionId (必須)	string	取得するコネクションの ID です。	NA

クエリ パラメーター

クエリ パラメーター	データ型	説明	既定値
includeConfigs	boolean	接続の設定を返します。構成の読み取りスコープを保持している呼び出し元のみ使用できます。API キーや OAuth トークンなどのシークレット値は返されません。	false

応答

200 OK

{
  "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 ヘッダーが指定されていませんでした。

401 未承認

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

403 Forbidden

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

404 見つかりません

コネクションが存在しないか、要求の対象のフォルダー以外のフォルダーにあります。要求されたフォルダーの外部にある接続の場合は、 ではなく 404を返 403。