Coder Provisioning API
The Provisioning API from Coder — 1 operation(s) for provisioning.
The Provisioning API from Coder — 1 operation(s) for provisioning.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.curl "https://apis.io/api/v1/apis/coder:coder-provisioning-api"
curl "https://apis.io/api/v1/apis?limit=25"
Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
description: Coderd is the service created by running coder server. It is a thin API that connects workspaces, provisioners and users. coderd stores its state in Postgres and is the only service that communicates with Postgres.
title: Coder Provisioning API
termsOfService: https://coder.com/legal/terms-of-service
contact:
name: API Support
url: https://coder.com
email: support@coder.com
license:
name: AGPL-3.0
url: https://github.com/coder/coder/blob/main/LICENSE
version: '2.0'
servers:
- url: /
tags:
- name: Provisioning
paths:
/api/v2/organizations/{organization}/provisionerdaemons:
get:
tags:
- Provisioning
summary: Get provisioner daemons
operationId: get-provisioner-daemons
parameters:
- description: Organization ID
name: organization
in: path
required: true
schema:
type: string
format: uuid
- description: Page limit
name: limit
in: query
schema:
type: integer
- description: Filter results by job IDs
name: ids
in: query
style: form
explode: false
schema:
type: array
format: uuid
items:
type: string
- description: Filter results by status
name: status
in: query
schema:
type: string
enum:
- pending
- running
- succeeded
- canceling
- canceled
- failed
- unknown
- pending
- running
- succeeded
- canceling
- canceled
- failed
- description: Provisioner tags to filter by (JSON of the form `{'tag1':'value1','tag2':'value2'}`)
name: tags
in: query
schema:
type: string
responses:
'200':
description: OK
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/codersdk.ProvisionerDaemon'
security:
- CoderSessionToken: []
components:
schemas:
codersdk.ProvisionerJobStatus:
type: string
enum:
- pending
- running
- succeeded
- canceling
- canceled
- failed
- unknown
x-enum-varnames:
- ProvisionerJobPending
- ProvisionerJobRunning
- ProvisionerJobSucceeded
- ProvisionerJobCanceling
- ProvisionerJobCanceled
- ProvisionerJobFailed
- ProvisionerJobUnknown
codersdk.ProvisionerDaemon:
type: object
properties:
api_version:
type: string
created_at:
type: string
format: date-time
current_job:
$ref: '#/components/schemas/codersdk.ProvisionerDaemonJob'
id:
type: string
format: uuid
key_id:
type: string
format: uuid
key_name:
description: Optional fields.
type: string
last_seen_at:
type: string
format: date-time
name:
type: string
organization_id:
type: string
format: uuid
previous_job:
$ref: '#/components/schemas/codersdk.ProvisionerDaemonJob'
provisioners:
type: array
items:
type: string
status:
enum:
- offline
- idle
- busy
allOf:
- $ref: '#/components/schemas/codersdk.ProvisionerDaemonStatus'
tags:
type: object
additionalProperties:
type: string
version:
type: string
codersdk.ProvisionerDaemonStatus:
type: string
enum:
- offline
- idle
- busy
x-enum-varnames:
- ProvisionerDaemonOffline
- ProvisionerDaemonIdle
- ProvisionerDaemonBusy
codersdk.ProvisionerDaemonJob:
type: object
properties:
id:
type: string
format: uuid
status:
enum:
- pending
- running
- succeeded
- canceling
- canceled
- failed
allOf:
- $ref: '#/components/schemas/codersdk.ProvisionerJobStatus'
template_display_name:
type: string
template_icon:
type: string
template_name:
type: string
securitySchemes:
AIGatewayKey:
type: apiKey
name: X-AI-Governance-Gateway-Key
in: header
Authorization:
type: apiKey
name: Authorization
in: header
CoderSessionToken:
type: apiKey
name: Coder-Session-Token
in: header
x-provenance:
method: harvested
publisher: Coder
source: https://raw.githubusercontent.com/coder/coder/main/coderd/apidoc/swagger.json
note: split by refine-openapis from the provider's own published document, verified by fetch (openapi/_original/*.fetch.json);
stamped by stamp-openapi-provenance.py (roadmap#793)