---
title: "Create template version dry-run"
method: POST
path: "/api/v2/templateversions/{templateversion}/dry-run"
tags: ["Templates"]
---

# Create template version dry-run

`POST /api/v2/templateversions/{templateversion}/dry-run`

## Path parameters

- `templateversion` string, uuid, required

## Request body

- CodersdkCreateTemplateVersionDryRunRequest
  - `rich_parameter_values` CodersdkWorkspaceBuildParameter[]
    - `name` string
    - `value` string
  - `user_variable_values` CodersdkVariableValue[]
    - `name` string
    - `value` string
  - `workspace_name` string

## Response `201`

Created

- CodersdkProvisionerJob
  - `available_workers` string[]
  - `canceled_at` string, date-time
  - `completed_at` string, date-time
  - `created_at` string, date-time
  - `error` string
  - `error_code` 'REQUIRED_TEMPLATE_VARIABLES' | 'INSUFFICIENT_QUOTA'
  - `file_id` string, uuid
  - `id` string, uuid
  - `initiator_id` string, uuid
  - `input` CodersdkProvisionerJobInput
    - `error` string
    - `template_version_id` string, uuid
    - `workspace_build_id` string, uuid
  - `logs_overflowed` boolean
  - `metadata` CodersdkProvisionerJobMetadata
    - `template_display_name` string
    - `template_icon` string
    - `template_id` string, uuid
    - `template_name` string
    - `template_version_name` string
    - `workspace_build_transition` 'start' | 'stop' | 'delete'
    - `workspace_id` string, uuid
    - `workspace_name` string
  - `organization_id` string, uuid
  - `queue_position` integer
  - `queue_size` integer
  - `started_at` string, date-time
  - `status` 'pending' | 'running' | 'succeeded' | 'canceling' | 'canceled' | 'failed' | 'unknown'
  - `tags` object
  - `type` 'template_version_import' | 'workspace_build' | 'template_version_dry_run'
  - `worker_id` string, uuid
  - `worker_name` string

---

[API](https://skmtc.net/coder/apis/coder-api.md) · [All operations](https://skmtc.net/coder/apis/coder-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/coder/coder-api/versions/56b6e9f08540/schema)