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

Workato error
{ "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

  1. Use a genie client API key or OAuth access token for runtime calls.
  2. Call the genie-api host for your workspace's data center.
  3. If the key was regenerated, update your backend with the new key.
  4. Send the header exactly as Authorization: Bearer <token>.
  5. If you contact support, include the request_id from the response.

04Official documentation

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

The iPaaS Brief

Subscribe to The iPaaS Brief.

The iPaaS newsletter for the people who run integrations. From iPaaS Group.

Free. You finish on theipaasbrief.com and confirm by email.