レガシーAPIキーの廃止 ​

Workatoは、2023年1月11日にレガシーAPIキー認証からAPIクライアント認証に移行しました。 この移行中、機能を維持するために、レガシーAPIキーは"Migrated API client"という名前のAPIクライアントに自動的に移動されました。

2025年7月14日現在、レガシーAPIキーは完全に廃止されています。レガシーAPIキーを通じて認証されたAPIリクエストは拒否されます。 影響を受けるユーザーには2025年04月14日にメール通知が送信され、レガシーAPIキーをまだ使用しているユーザーには2025年07月に第2弾が送信されました。 2025年10月14日以降、レガシーAPIキー機能はすべてのユーザーに対して完全に削除されます。

これは自分に影響しますか ​

現在、次の方法でレガシーAPIキー認証を使用している場合は影響を受けます:

• APIリクエストのx-user-tokenヘッダーおよびx-user-emailヘッダー
• クエリパラメーターのAPIキーおよびメールアドレス
• ワークスペース内の"Migrated API client"

レガシーAPIキーの場所 ​

レガシーAPIキーは、Admin権限を持つ"Migrated API client"としてワークスペース管理者＞APIクライアントに移動されました。 クライアントトークンは元のAPIキーです。

Environmentが有効化されたワークスペースでは、各Environmentに対して個別のクライアントが自動的に作成されました: Migrated API client - {Environment name}。

APIクライアント認証への移行 ​

レガシーAPIキー認証からAPIクライアント認証に移行するには、次の手順を完了します:

認証形式の変更 ​

レガシー形式（廃止）:

curl -X GET https://www.workato.com/api/users/me \
     -H 'x-user-token: <legacy_api_key>' \
     -H 'x-user-email: <user_email>'

新しい形式（必須）:

curl -X GET https://www.workato.com/api/users/me \
     -H 'Authorization: Bearer <api_client_token>'