Workato · Agent Studio headless API
401 auth_failed (headless API)
Short answer
A 401 with error_code auth_failed from the headless API means the token in the request was not accepted. Check, in this order, the token type, the data center host, whether the key was rotated, and the Authorization header format.
VerifiedLast verified
01Error text
{ "error_code": "auth_failed", "error_message": "Authentication failed.", "request_id": "<uuid>" }02Likely causes
- Wrong token type. Runtime calls use a genie client API key or OAuth access token, not the
wrkaus-…Developer API token, which is for provisioning only. - Wrong data center.
- The key expired or was rotated. Regenerating a key invalidates the previous one.
- The header is malformed.
03How to fix it
- Use a genie client API key or OAuth access token for runtime calls.
- Call the
genie-apihost for your workspace's data center. - If the key was regenerated, update your backend with the new key.
- Send the header exactly as
Authorization: Bearer <token>. - If you contact support, include the
request_idfrom the response.
04Official documentation
→Related errors
- 401 user_nonactive_or_missing (headless API)A 401 with error_code user_nonactive_or_missing means the X-IDP-User-Id header does not resolve to an active, allow-listed user. Confirm the user is active and belongs to an allow-listed user group.
- 401 UnauthorizedA 401 Unauthorized error in Workato means the external service rejected the authentication credentials sent with the request. Disconnect the app connection and reconnect it with valid, current credentials.
- access to this API has been disallowedA Workato API platform endpoint returns 401 with the message access to this API has been disallowed when there is a problem with the API token, the request configuration or the access policy. It is also returned when the request URL is incorrect or the endpoint is not active.
Test every fix in a non-production environment before you apply it to production. See how entries are verified.
More for Workato work:Open Workato jobsWorkato rates and salariesHire a senior Workato developer