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

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

BMC Remedy AR System REST API overview

The REST API is a simple stateless architecture that runs over the HTTP. The AR System server uses JavaScript Object Notation (JSON) format to transmit data between a server and a web application. The advantage of REST is having a limited number of operations for the interactions between clients and services.

Note

The BMC Remedy AR System server uses Jetty as a web server to service the REST API requests. BMC recommends to use Secure Sockets Layer (SSL) certificates with Jetty server to service the REST API requests. For more information, see Configuring the REST API.

The REST API uses the base URI for the web service, such as https://<localhost>:<port>/api/{namespace}/{version} 

api - is the default prefix.

namespace - is used to help separate the different APIs.

version - is the version used for particular REST API.

Note

The root URL path for REST API in BMC Remedy AR System is
https://<localhost>:<port>
/api/arsys/v1. Any partial URLs, for example, /entry/{formName} referred to the documentation are assumed to have this prefix.

The API is a web service that conforms to the architectural principles of Representational State Transfer (REST). Each API is called by issuing a standard HTTP request method: POST, GET, PUT, or DELETE (more commonly known as the CRUD operations: Create, Read, Update, and Delete).

The client creates new entries by issuing POST requests. The details of an individual entry or list of entries is retrieved using a GET request. The client issues PUT requests to modify an entry object. When an entry object is no longer needed, the client issues a DELETE request to remove the entry. 

The following topics provide details about the BMC Remedy AR System REST API.

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

Comments

  1. Brock Wakham

    Where are the details of the CMDB REST Operations?

    Oct 16, 2015 04:54
    1. Prachi Kalyani

      Hello Brock,

      The CMDB REST operations are documented in the BMC Atrium Core 9.0 space. The link to the topic is REST API.

      Thanks,

      Prachi

      Oct 18, 2015 11:29
  2. Brock Wakham

    Prachi, thanks for adding the link.  That is most helpful.

    Oct 19, 2015 10:32
  3. Alejandro Vidaurri de la cruz

    REST API on URL http://ARSERVER/api/arsys/v1/entry/FORMNAME

    Should always return DATABASE field names, 

    For example  Getting an Entry on AR System User Preference form should return this

    "values": {
    "Request ID": "000000000000001",
    "Submitter": "Demo",

    "Submitter" is the database field name

    If you have overlaid a form and you are getting Field Labels instead of Field Names, you are facing a defect

    Upgrading to latest AR server and Hotfix is recommended

     

    Feb 10, 2017 08:30
  4. Sudhakar Govindasamy

    Does BMC Remedy expose REST API by default? or Do we need to configure it in Admin console within Remedy? Where can we find that this is already exposed?

    Feb 19, 2018 07:18
  5. Sachin Dhamale

    Is this API work for ITSM application?

    Also i am looking for REST API which create, edit and change the status of record in ITSM application using REST API.

    Can you please assist on this


    Oct 02, 2018 12:31