Workato · API platform
access to this API has been disallowed
Short answer
A 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.
VerifiedLast verified
01Error text
401 Unauthorized
access to this API has been disallowed02Likely causes
- There is a problem with the API token or the request configuration, or the request violates the access policy.
- The request URL is incorrect. Some requests to an incorrect URL are returned as 401 and not 404.
- The endpoint is not active.
03How to fix it
- Check that the request sends the API token in the header the endpoint expects, with the correct header name.
- Check the request URL against the endpoint's URL, and confirm the endpoint is active.
- Confirm the client's access policy allows the request.
- Export the API logs and read the Status details column. It narrows the cause:
4011Unrecognized token,4012Missing token,4013Invalid credentials,4014Endpoint not found,4040Recipe is inactive. - Fix what the status detail points to: correct the token for
4011, add or rename the token header for4012, renew expired JWT or OAuth 2.0 credentials for4013, correct the path for4014, and start the API recipe for4040.
04Official documentation
→Related errors
- 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.
- concurrency limit exceeded / rate/quota limit exceededA Workato API platform endpoint returns 429 with concurrency limit exceeded or rate/quota limit exceeded when the client goes over a limit set by its access policy. Slow the client down, or raise the limit in the access policy.
- recipe execution takes too longA Workato API platform endpoint returns 504 with recipe execution takes too long when the API recipe's job does not respond within the endpoint's timeout. The default is 30 seconds and the maximum is 240 seconds, so make the recipe faster or raise the endpoint's timeout.
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