User:Catlee/BuildAPI

REST Interface

List of request methods, urls, and parameters

PUT and DELETE can also be achieved by POSTing to the URL with a POST field "_method" set to PUT or DELETE. GET /builds/branches -> list of branches

GET /builds/{branch} -> list of recent builds, including completed, running and pending

GET /builds/{branch}/build/{buildid} -> information about a particular build

GET /builds/{branch}/buildrequest/{requestid} -> information about a particular build request

GET /builds/{branch}/rev/{revision} -> list of builds for this revision

GET /builds/{branch}/builders -> list of valid builder names

GET /builds/{branch}/builders/{buildername} -> list of recent builds, including completed, running, and pending for this builder name

PUT /builds/{branch}/buildrequest/{requestid} -> update this build

• priority (required, sets the build request's priority)

DELETE /builds/{branch}/build/{buildid} -> cancel this build

DELETE /builds/{branch}/buildrequest/{requestid} -> cancel this buildrequest

• onlyifrunning (optional, set to only cancel builds if they're running)
• onlyifpending (optional, set to only cancel builds if they're pending)

DELETE /builds/{branch}/rev/{revision} -> cancel pending/running builds for this revision

• onlyifrunning (optional, set to only cancel builds if they're running)
• onlyifpending (optional, set to only cancel builds if they're pending)
• killmerged (optional, set to cancel builds that are merged with other revisions)

POST /builds/{branch}/rev/{revision} -> create a new build with this revision

• buildername (required, which builder to create builds for, can be specified multiple times)

POST /builds/{branch}/builders/{buildername} -> create a new build on this builder

• revision (optional, which revision to build)

POST /builds/{branch}/build -> rebuilds an old build on this branch

• buildid (this or requestid required, which build to rebuild)
• requestid (which request to rebuild)

Object definitions

Builds:

• buildid
• buildrequests
• buildnumber
• buildername
• branch
• revision
• starttime
• endtime
• status

Build Requests:

• buildrequestid
• buildername
• branch
• revision
• submittime