Skip to content
Mark Petrovic edited this page Oct 20, 2015 · 4 revisions

HTTP Endpoints

Home page

GET /decap

Version

GET /api/v1/version

Teams

GET /api/v1/teams

Projects

Supply query parameter team to narrow results to a specific Team

GET /api/v1/projects

Project Refs

Get git refs for a project

GET /api/v1/projects/:team/:project/refs

Builds

GET /api/v1/builds/:team/:project

Stop a currently executing build by deleting the backing pod

DELETE /api/v1/builds/:id   

Execute a Build Manually

POST /api/v1/builds/:team/:project?branch=b1&branch=b2

Logs

By buildID. Returns a gzipped console log for this build.

GET /api/v1/logs/:id

Set "Accept: text/plain" to get the plain text version of the log.

Artifacts

By buildID. Returns a tar-gzipped set of artifacts for this build.

GET /api/v1/artifacts/:id"

Set "Accept: text/plain" to get the plain text listing of tar file names.

Deferred builds

GET /api/v1/deferred
POST /api/v1/deferred?key=keyval

where keyval is the key of the deferred build to clear, and is determined from a call to GET /api/v1/deferred.

Post-commit hooks

By repomanager, where currently supported values are github and buildscripts. buildscripts is special, and is a hook to force decap to re-clone the buildscripts repo to pick up changes.

POST /hooks/:repomanager

Shutdown the build queue

POST /api/v1/shutdown/:state

where :state is open or close. The HTTP entity body is ignored.

If close, no new builds will be accepted for launching until the state is set to open.

To get the current shutdown state

GET /api/v1/shutdown

Toggle logging level

POST /api/v1/loglevel/:level

where :level is default or debug.