Octopus Deploy Documentation

API examples

Last updated

As you work with the Octopus API, you may need some guidance on how to perform certain actions or what parameters to provide. The OctopusDeploy-API GitHub repository contains many examples using the API, with solutions covering:

  • PowerShell using the REST API.
  • PowerShell using Octopus.Client.
  • C# using Octopus.Client.
  • Python using the REST API.
  • Go using the REST API.

In addition, we also have a wide range of some of the more common examples here as well.

Using the scripts

To use the example scripts, you'll need to provide your Octopus Server URL and an API Key. There may be other values that need to be updated to fit your scenario such as Space, Project, and Environment names.

The examples provided are for reference and should be modified and tested prior to using in a production Octopus instance.

C# examples

The C# examples are written using dotnet script. The same logic can be used in a standard C# application.

Octopus.Client examples

Examples using Octopus.Client require the library to be installed and a path to the library to be provided.

Python examples

The Python examples are written using Python 3 and use the Requests library. Some examples also use the urllib module.

Go examples

The Go examples are written using the go-octopusdeploy Client.

Bulk operations

Sometimes you want to perform an action on a resource in Octopus multiple times. For example, connecting a tenant to all of your projects. Having to run a script that performs an operation once, repeatedly, can become tedious.

To help with this, we've included examples of bulk operations using the Octopus REST API.

Explore examples

Explore the REST API examples further in this section:

Need support? We're here to help.