フォルダー

カスタマーアカウント内のフォルダーを管理するには、以下のエンドポイントを使用します。

クイックリファレンス

タイプ	リソース	説明
GET	/api/managed_users/:id/folders	フォルダーのリストを表示します。
POST	/api/managed_users/:id/folders	フォルダーを作成します。

フォルダーのリストの表示

カスタマーアカウント内のすべてのフォルダーのリストを表示します。

GET /api/managed_user_id/folders

URL パラメータ

名前	型	説明
managed_user_id	string 必須	Workato Embedded カスタマーアカウント ID または外部 ID。 外部 ID は、E を先頭に付ける必要があります (例 : Ea2300)。結果として返される ID は URL エンコードされます。

クエリパラメータ

名前	型	説明
parent_id	string	親フォルダー ID。デフォルトでホームフォルダーに設定されます。
page	integer	ページ番号。デフォルトで1に設定されます。
per_page	integer	ページサイズ。デフォルトで100に設定されます (最大値は100です)。

サンプルリクエスト

curl  -X GET 'https://www.workato.com/api/managed_users/1199/folders?parent_id=12323' \
      -H 'x-user-email: <email>' \
      -H 'x-user-token: <token>' \
      -H 'Content-Type: application/json' \

レスポンス

{
    "result": [
        {
            "id": 1789,
            "name": "Netsuite production",
            "parent_id": 4515,
            "created_at": "2020-07-16T10:49:53.337-07:00",
            "updated_at": "2020-07-16T10:49:53.347-07:00"
        }
    ]
}

フォルダーの作成

指定された親フォルダーの中に新しいフォルダーを作成します。親フォルダー ID が指定されなかった場合は、作成されたフォルダーがトップレベルのフォルダー (ホームフォルダー内) になります。

POST /api/managed_users/:managed_user_id/folders

URL パラメータ

名前	型	説明
managed_user_id	string 必須	Workato Embedded カスタマーアカウント ID または外部 ID。 外部 ID は、E を先頭に付ける必要があります (例 : Ea2300)。結果として返される ID は URL エンコードされます。

ペイロード

名前	型	説明
name	string 必須	フォルダーの名前。
parent_id	string	親フォルダー ID。デフォルトでホームフォルダーに設定されます。

サンプルリクエスト

curl  -X POST https://www.workato.com/api/managed_users/1892/folders \
      -H 'x-user-email: <email>' \
      -H 'x-user-token: <token>' \
      -H 'Content-Type: application/json' \
      -d  '{
            "name": "Salesforce folder"
          }'

レスポンス

{
  "id": 3498583,
}