How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Coder Templates API

The Templates API from Coder — 33 operation(s) for templates.

Coder Templates API is one of 32 APIs that Coder publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Templates. The published artifact set on APIs.io includes an OpenAPI specification and API documentation.

This API exposes 38 operations across 33 paths, and defines 76 schemas. It is described by OpenAPI 3.2.0, at version 2.0.

Requests are made against a single base URL, https://{coderHost}/api/v2.

38 operations 33 paths 76 schemas 1 DELETE25 GET5 PATCH7 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.2.0
API Version
2.0
Base URL
https://coder.example.com/api/v2
Authentication
API Key
License
Terms of Service
Resource Areas
1

Authentication & Security 1

Coder Templates API declares 1 security scheme for authenticating requests. An API key is passed in the header as Coder-Session-Token (CoderSessionToken). By default, every request must be authenticated.

Paths & Operations 38

Across 33 paths, the API surfaces 38 operations — 1 DELETE, 25 GET, 5 PATCH, 7 POST. Each is listed below with its method, path, parameters, and response codes.

Templates 38
GET
/api/v2/organizations/{organization}/templates
Get templates by organization
get-templates-by-organization 1 param → 200
POST
/api/v2/organizations/{organization}/templates
Create template by organization
create-template-by-organization 1 param body → 200
GET
/api/v2/organizations/{organization}/templates/examples
Get template examples by organization
get-template-examples-by-organization 1 param → 200
GET
/api/v2/organizations/{organization}/templates/{templatename}
Get templates by organization and template name
get-templates-by-organization-and-template-name 2 params → 200
GET
/api/v2/organizations/{organization}/templates/{templatename}/versions/{templateversionname}
Get template version by organization, template, and name
get-template-version-by-organization-template-and-name 3 params → 200
GET
/api/v2/organizations/{organization}/templates/{templatename}/versions/{templateversionname}/previous
Get previous template version by organization, template, and name
get-previous-template-version-by-organization-template-and-name 3 params → 200204
POST
/api/v2/organizations/{organization}/templateversions
Create template version by organization
create-template-version-by-organization 1 param body → 201
GET
/api/v2/templates
Get all templates
get-all-templates → 200
GET
/api/v2/templates/examples
Get template examples
get-template-examples → 200
GET
/api/v2/templates/{template}
Get template settings by ID
get-template-settings-by-id 1 param → 200
DELETE
/api/v2/templates/{template}
Delete template by ID
delete-template-by-id 1 param → 200
PATCH
/api/v2/templates/{template}
Update template settings by ID
update-template-settings-by-id 1 param body → 200
GET
/api/v2/templates/{template}/daus
Get template DAUs by ID
get-template-daus-by-id 1 param → 200
GET
/api/v2/templates/{template}/versions
List template versions by template ID
list-template-versions-by-template-id 5 params → 200
PATCH
/api/v2/templates/{template}/versions
Update active template version by template ID
update-active-template-version-by-template-id 1 param body → 200
POST
/api/v2/templates/{template}/versions/archive
Archive template unused versions by template id
archive-template-unused-versions-by-template-id 1 param body → 200
GET
/api/v2/templates/{template}/versions/{templateversionname}
Get template version by template ID and name
get-template-version-by-template-id-and-name 2 params → 200
GET
/api/v2/templateversions/{templateversion}
Get template version by ID
get-template-version-by-id 1 param → 200
PATCH
/api/v2/templateversions/{templateversion}
Patch template version by ID
patch-template-version-by-id 1 param body → 200
POST
/api/v2/templateversions/{templateversion}/archive
Archive template version
archive-template-version 1 param → 200
PATCH
/api/v2/templateversions/{templateversion}/cancel
Cancel template version by ID
cancel-template-version-by-id 1 param → 200
POST
/api/v2/templateversions/{templateversion}/dry-run
Create template version dry-run
create-template-version-dry-run 1 param body → 201
GET
/api/v2/templateversions/{templateversion}/dry-run/{jobID}
Get template version dry-run by job ID
get-template-version-dry-run-by-job-id 2 params → 200
PATCH
/api/v2/templateversions/{templateversion}/dry-run/{jobID}/cancel
Cancel template version dry-run by job ID
cancel-template-version-dry-run-by-job-id 2 params → 200
GET
/api/v2/templateversions/{templateversion}/dry-run/{jobID}/logs
Get template version dry-run logs by job ID
get-template-version-dry-run-logs-by-job-id 6 params → 200
GET
/api/v2/templateversions/{templateversion}/dry-run/{jobID}/matched-provisioners
Get template version dry-run matched provisioners
get-template-version-dry-run-matched-provisioners 2 params → 200
GET
/api/v2/templateversions/{templateversion}/dry-run/{jobID}/resources
Get template version dry-run resources by job ID
get-template-version-dry-run-resources-by-job-id 2 params → 200
GET
/api/v2/templateversions/{templateversion}/dynamic-parameters
Open dynamic parameters WebSocket by template version
open-dynamic-parameters-websocket-by-template-version 1 param → 101
POST
/api/v2/templateversions/{templateversion}/dynamic-parameters/evaluate
Evaluate dynamic parameters for template version
evaluate-dynamic-parameters-for-template-version 1 param body → 200
GET
/api/v2/templateversions/{templateversion}/external-auth
Get external auth by template version
get-external-auth-by-template-version 1 param → 200
GET
/api/v2/templateversions/{templateversion}/logs
Get logs by template version
get-logs-by-template-version 5 params → 200
GET
/api/v2/templateversions/{templateversion}/parameters
Removed: Get parameters by template version
removed-get-parameters-by-template-version 1 param → 200
GET
/api/v2/templateversions/{templateversion}/presets
Get template version presets
get-template-version-presets 1 param → 200
GET
/api/v2/templateversions/{templateversion}/resources
Get resources by template version
get-resources-by-template-version 1 param → 200
GET
/api/v2/templateversions/{templateversion}/rich-parameters
Get rich parameters by template version
get-rich-parameters-by-template-version 1 param → 200
GET
/api/v2/templateversions/{templateversion}/schema
Removed: Get schema by template version
removed-get-schema-by-template-version 1 param → 200
POST
/api/v2/templateversions/{templateversion}/unarchive
Unarchive template version
unarchive-template-version 1 param → 200
GET
/api/v2/templateversions/{templateversion}/variables
Get template variables by template version
get-template-variables-by-template-version 1 param → 200

Schemas 76

The contract defines 76 schemas that model the data the API accepts and returns. The most detailed are codersdk.Template (35 properties), codersdk.WorkspaceAgent (33 properties), codersdk.UpdateTemplateMeta (23 properties), codersdk.ProvisionerJob (21 properties). Each schema is shown below with its type and property counts.

codersdk.UpdateActiveTemplateVersion
object
1 property 1 required
codersdk.Template
object
35 properties
codersdk.TemplateBuildTimeStats
object
codersdk.ProvisionerJob
object
21 properties
codersdk.TemplateAutostartRequirement
object
1 property
codersdk.LogLevel
string
codersdk.AgentSubsystem
string
codersdk.ValidationMonotonicOrder
string
codersdk.PreviewParameterOption
object
4 properties
codersdk.WorkspaceAppStatus
object
10 properties
codersdk.FriendlyDiagnostic
object
4 properties
codersdk.DAUsResponse
object
2 properties
codersdk.TransitionStats
object
2 properties
codersdk.LogSource
string
codersdk.ProvisionerJobMetadata
object
8 properties
codersdk.TemplateExample
object
7 properties
codersdk.DiagnosticSeverityString
string
codersdk.DynamicParametersRequest
object
3 properties
codersdk.TemplateVersionParameter
object
17 properties
codersdk.TemplateVersionWarning
string
codersdk.WorkspaceAgentHealth
object
2 properties
codersdk.NullHCLString
object
2 properties
codersdk.WorkspaceTransition
string
codersdk.WorkspaceAgentScriptStatus
string
codersdk.VariableValue
object
2 properties
codersdk.TemplateVersionVariable
object
7 properties
codersdk.WorkspaceResource
object
11 properties
codersdk.Healthcheck
object
3 properties
codersdk.DiagnosticExtra
object
1 property
codersdk.WorkspaceAgentStatus
string
codersdk.Preset
object
7 properties
codersdk.MinimalUser
object
4 properties 2 required
codersdk.WorkspaceAgentStartupScriptBehavior
string
codersdk.JobErrorCode
string
codersdk.PreviewParameterStyling
object
4 properties
codersdk.ProvisionerStorageMethod
string
codersdk.TemplateVersionParameterOption
object
4 properties
codersdk.ArchiveTemplateVersionsRequest
object
1 property
codersdk.UpdateTemplateMeta
object
23 properties
codersdk.CORSBehavior
string
codersdk.WorkspaceBuildParameter
object
2 properties
codersdk.Response
object
3 properties
codersdk.WorkspaceAppStatusState
string
codersdk.TemplateAutostopRequirement
object
2 properties
codersdk.WorkspaceResourceMetadata
object
3 properties
codersdk.WorkspaceAgentLogSource
object
5 properties
codersdk.ValidationError
object
2 properties 2 required
codersdk.PatchTemplateVersionRequest
object
2 properties
codersdk.MatchedProvisioners
object
3 properties
codersdk.WorkspaceApp
object
17 properties
codersdk.DisplayApp
string
codersdk.ParameterFormType
string
codersdk.PreviewParameterValidation
object
5 properties
codersdk.ProvisionerJobStatus
string
codersdk.CreateTemplateVersionRequest
object
9 properties 2 required
codersdk.ProvisionerJobType
string
codersdk.WorkspaceAgentLifecycle
string
codersdk.DAUEntry
object
2 properties
codersdk.WorkspaceAppOpenIn
string
codersdk.ProvisionerJobInput
object
3 properties
codersdk.PresetParameter
object
2 properties
codersdk.WorkspaceAgentPortShareLevel
string
codersdk.CreateTemplateRequest
object
20 properties 2 required
codersdk.DynamicParametersResponse
object
3 properties
uuid.NullUUID
object
2 properties
codersdk.TemplateVersionExternalAuth
object
7 properties
codersdk.WorkspaceAgentScript
object
12 properties
codersdk.TemplateVersion
object
14 properties
codersdk.WorkspaceAgent
object
33 properties
codersdk.OptionType
string
codersdk.WorkspaceAppHealth
string
codersdk.PreviewParameter
object
16 properties
codersdk.WorkspaceAppSharingLevel
string
codersdk.DERPRegion
object
2 properties
codersdk.CreateTemplateVersionDryRunRequest
object
3 properties
codersdk.ProvisionerJobLog
object
6 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

coder-templates-api-openapi.yml Raw ↑

Other APIs Coder publishes across the network.

Coder Workspaces API
Coder Templates API
Coder Users API
Coder Workspace Agents API
Coder Enterprise API
Coder Agents API
Coder AI Bridge API
Coder AI Providers API
Coder Applications API
Coder Audit API
Coder Authorization API
Coder Builds API
Where this information came from

This is an independent, third-party profile of Coder Templates API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.