Public API

Alpha

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"
   

   Copy

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.