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.