The fortimail rest api documentation is not great.
It can be alot better. Although it can also be a lot worse.
I will go through a few examples of common things that can be done with the api over HTTP (It isn't rest although they think it is) - no hypermedia and making use of
reqAction as preference over HTTP verbs - although HTTP verbs are used.
An excerpt from the API docs:
Supported values for 'reqAction' attribute of all JSON requests: 1 ---GET 2 ---CREATE 3 ---DELETE 5---UPDATET 14 ---MOVE Note: If reqAction is present in JSON, it takes precedence over HTTP method header (i.e. HTTP GET/POST/PUT/DELETE)