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.


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 "" \
    -H "accept: application/json" \
    -H "Session-Token: Bk...nt"


Please note that the API is under active development; expect breaking changes as we finalize the endpoints.

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