Skip to content

Home

Jump to bottom
Adrian Clark edited this page Jan 30, 2014 · 16 revisions

Octopus Deploy is a user-friendly automated deployment tool for .NET developers. This GitHub repository exists to provide documentation for the Octopus Deploy 2.0 HTTP API.

In Octopus Deploy 2.0, we've made a lot of improvements to the API. While many of the concepts are the same and should be easy to migrate, it is important to note that the Octopus 1.x and Octopus 2.x APIs are not compatible.

Jumping in

The Octopus Deploy API is available at:

http://<your-octopus-installation>/api

You'll need an API key to access the API. You can get your API key from your profile page on the Octopus web portal. This should be sent in the X-Octopus-ApiKey HTTP header, or in an apikey query string parameter. Learn more about authenticating.

Design goals

When building this new API, we worked with the following goals in mind:

  1. To be friendly and easy to figure out
  2. To be hypermedia driven, using links and the occasional URI template (read more)
  3. To have the HTML user interface for Octopus consume the API - this means that anything you can do via the application can also be done via the API
  4. To have a nice client library for .NET available via NuGet

Learning more

Use the sidebar on the right to learn more about what the Octopus Deploy API supports.

Clone this wiki locally