With the upcoming release of GoCD 15.2, we'd like to begin unifying and improving some of the existing APIs that GoCD supports.

GoCD's APIs are fairly old, have inconsistent and unpredictable content types (csv, xml, json, plain text).

Going forward, we would like to announce an ongoing effort to improve these APIs to use something that is more modern, easy to discover, learn and build API clients for.

We would be using the JSON HAL specification. Our API guidelines are published on our RFC.

This will give us the opportunity to leverage Ruby and Rails to build these APIs, which should make it easier to incrementally iterate through and improve existing APIs to bring them to parity with our new guidelines.

We welcome any feedback to improve our guidelines and contributions to improve existing APIs.