New
The Gartner Hype Cycle Emerging Technologies Report is out!

Download now

To help you integrate Coder into your automated workflows, we've documented our API.

Authentication

Use of the API requires authentication with a session token. You can generate one using the Coder CLI:

  1. If you haven't already, authenticate your CLI with your workspace.

  2. Run coder tokens create <TOKEN_NAME>

  3. Save the token that's returned to use in your HTTP headers:

    curl \
    -X GET "https://apidocs.coder.com/api/" \
    -H "accept: application/json" \
    -H "Session-Token: Bk...nt"
    

Documentation

Please note that the API is under active development; expect breaking changes as we finalize the endpoints. We will place stable API routes under the /api/v1 path.

See an opportunity to improve our docs? Make an edit.