This documentation supports the 19.02 version of Remedy Action Request System.

To view the latest version, select the version from the Product version menu.

Troubleshooting the REST API

To understand errors from the REST API, examine the status code of the response along with the response body if present. If that does not help, and you have access to the appliance's logs, look at the log file for the REST API subsystem (setting the log level to DEBUG temporarily can be useful).

Also, here are some specific scenarios you might encounter:

I can't connect to the API at all over HTTPS

Configure HTTPS or enable API access over HTTP.

I keep getting 403 Forbidden errors back from the API

This error occurs if you have configured HTTPS and you try to access HTTP. If your HTTP(S) configuration is correct, but you still receive 403 errors, the user accessing the API might not have permission to perform the actions required by the endpoint.

I keep getting 401 Unauthorized errors back from the API

This error indicates that you could not be authenticated using the token expected in the HTTP "Authorization" header. Several reasons could cause this problem:

  • The "Authorization" header itself is missing or invalid.
  • The token is missing from the header or is invalid.
  • The token has expired. Note that tokens only expire if they are generated from the /api/tokenendpoint (as opposed to being generated in the user interface). In this case, you can generate a new one with another call to the same endpoint. If you are using the Swagger UI, the interaction with /api/token is hidden from you, but you can trigger another call to the endpoint by refreshing the Swagger UI and entering your username and password again.
  • The user that owns the token has been deactivated or deleted.

Both the new UI and the REST APIs run on Jetty. 

The Jetty server does not respond to client REST API request. The new BMC CMDB user interface does not launch.

This issue is observed when you configure the Jetty server by using a secured socket layer (SSL). Perform the following steps:

  1. Open the arserver.config file, located in the <Install directory>\ARSystem folder.
  2. Add the following line in the arserver.config file.

How to turn on logging for REST API related issues

For information about turning on logging for REST API related issues, see the article on BMC Communities.

Was this page helpful? Yes No Submitting... Thank you


  1. Thad Esser

    Under "Related Topics", the text "End points" does not have a link.

    Jul 31, 2019 08:41
  2. Thad Esser

    Also, in the first section, there is a bullet point that doesn't have any text associated.

    Jul 31, 2019 08:41
    1. Himanshu Raul

      Hi Thad,

      Thank you for your comment. We have updated the topic and the link.



      Aug 01, 2019 05:38