Embedded API - タグの割り当て ​

このエンドポイントを使用して、顧客ワークスペース内のアセットにタグを適用したり、アセットからタグを削除したりします。

レート制限 ​

タグ割り当てリソースには、次のレート制限があります:

クイックリファレンス ​

タグ割り当ての管理 ​

顧客ワークスペース内のアセットにタグを適用するか、アセットからタグを削除します。このエンドポイントでタグを付けられるのは、レシピとコネクションのみです。これらのアセットに1つ以上のタグを割り当てるか、既存のタグを削除できます。

POST https://YOUR_DATA_CENTER/api/v2/managed_users/:managed_user_id/tags_assignments

URLパラメータ ​

ペイロード ​

タグは、カスタマーワークスペース内のすべてのEnvironmentで利用できます。タグの割り当ては、managed_user_id として渡したワークスペースIDを持つEnvironment内のレシピおよびコネクションにのみ適用されます。

タグを作成し、レシピに割り当てて結果を検証する一連の手順については、Create and assign a tagを参照してください。

サンプルリクエスト ​

このリクエストは、Workato内のコネクションとレシピにタグを追加します。

curl  -X POST "https://YOUR_DATA_CENTER/api/v2/managed_users/:managed_user_id/tags_assignments" \
      -H "Authorization: Bearer <api_token>" \
      -H "Content-Type: application/json" \
      -d '{
            "add_tags": [":tag_handle"],
            "recipe_ids": [:recipe_id],
            "connection_ids": [:connection_id]
          }'

レスポンス ​

200 OKステータスは、Workatoがリクエストを受け付けたことを意味します。レスポンス本文ではコンテンツは返されません。

タグハンドルが認識されない場合でも、このエンドポイントは200 OKを返すため、200 OKステータスだけではタグが適用されたことは確認できません。アセットに割り当てられたタグを取得する例については、Create and assign a tagを参照してください。

タグの作成と割り当て ​

この例では、カスタマーワークスペースでタグを作成し、それをレシピに割り当てて、割り当てを確認します。コネクションにタグを付与するには、recipe_idsの代わりにconnection_idsを使用します。

curl  -X POST "https://YOUR_DATA_CENTER/api/v2/managed_users/:managed_user_id/tags" \
      -H "Authorization: Bearer <api_token>" \
      -H "Content-Type: application/json" \
      -d '{
            "title": "HR"
          }'

{
  "data": {
    "handle": "tag-Abx8sFmg-NWx3Lb-CD",
    "title": "HR",
    "description": null,
    "color": "plum"
  }
}

curl  -X POST "https://YOUR_DATA_CENTER/api/v2/managed_users/:managed_user_id/tags_assignments" \
      -H "Authorization: Bearer <api_token>" \
      -H "Content-Type: application/json" \
      -d '{
            "add_tags": ["tag-Abx8sFmg-NWx3Lb-CD"],
            "recipe_ids": [1234567]
          }'

curl  -X GET "https://YOUR_DATA_CENTER/api/v2/managed_users/:managed_user_id/tags?q[recipe_id_eq]=1234567" \
      -H "Authorization: Bearer <api_token>"

{
  "data": {
    "tags": [
      {
        "handle": "tag-Abx8sFmg-NWx3Lb-CD",
        "title": "HR",
        "description": null,
        "color": "plum",
        "created_at": "2026-10-14T09:11:17.344-07:00",
        "updated_at": "2026-10-14T09:11:17.344-07:00"
      }
    ]
  }
}