API Documentation

Hermes is designed as an API first so anything possible in the Web UI or command line tools would be available here.


Authentication is still in the works. Right now, Hermes API is expected to sit behing some kind of authenticating proxy.


In addition to the authentication header above all POST/PUT requests will be sent as json rather than form data and should include the header Content-Type: application/json


All responses will be in JSON format along with the header Content-Type: application/json set.

The JSON payload will be in one of two potential structures and will always contain a status field to distinguish between them. If the status field has a value of "ok" or "created", then the request (or creation, respectively) was successful and the response will be available the remaining fields.

    "status": "ok",
    "id": 1,

If the status field has a value of "error" then the response failed in some way. You will have access to the error from the error field which will contain an error code and message.

    "status": "error",
    "error": {
        "code": 404,
        "message": "Resource not found."