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)