HTTP Methods

The API supports the following HTTP methods:

GET

  • Used to query a resource or a list of resource.

POST

  • Used to create a new resource.
  • The data is submitted as a JSON object.
  • The return value is the pkid of the resource.

PUT

  • Used to update the data of a resource.
  • The resource URL includes the resource pkid.
  • The data to be updated is submitted as a JSON object.

PATCH

  • Used to update the data of a resource.
  • PATCH request body in JSON Patch format
  • Content-Type is “application/json-patch+json”
  • JSON Patch: http://tools.ietf.org/html/rfc6902

DELETE

  • Used to delete a resource.
  • The resource URL includes the resource pkid.
  • The DELETE method can also be used to delete multiple resources on one request as a “bulk delete”.