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.