description of the API, parameter for commiting jobs