---
title: "Update a monitor user template to a new version"
method: PUT
path: "/api/v2/monitor/template/{template_id}"
tags: ["Monitors"]
---

# Update a monitor user template to a new version

`PUT /api/v2/monitor/template/{template_id}`

Creates a new version of an existing monitor user template.

## Path parameters

- `template_id` string, required

## Request body

- MonitorUserTemplateUpdateRequest — Request for creating a new monitor user template version.
  - `data` MonitorUserTemplateUpdateData, required — Monitor user template data.
    - `attributes` MonitorUserTemplateRequestAttributes, required — Attributes for a monitor user template.
      - `description` string, nullable — A brief description of the monitor user template.
      - `monitor_definition` object, required — A valid monitor definition in the same format as the [V1 Monitor API](https://docs.datadoghq.com/api/latest/monitors/#create-a-monitor).
      - `tags` string[], required — The definition of `MonitorUserTemplateTags` object.
      - `template_variables` MonitorUserTemplateTemplateVariablesItems[] — The definition of `MonitorUserTemplateTemplateVariables` object.
        - `available_values` string[] — Available values for the variable.
        - `defaults` string[] — Default values of the template variable.
        - `name` string, required — The name of the template variable.
        - `tag_key` string — The tag key associated with the variable. This works the same as dashboard template variables.
      - `title` string, required — The title of the monitor user template.
    - `id` string, required — The unique identifier.
    - `type` 'monitor-user-template', required — Monitor user template resource type.

## Response `200`

OK

- MonitorUserTemplateResponse — Response for retrieving a monitor user template.
  - `data` MonitorUserTemplateResponseDataWithVersions — Monitor user template data.
    - `attributes` MonitorUserTemplate — A monitor user template object.
      - `created` string, date-time — The created timestamp of the template.
      - `description` string, nullable — A brief description of the monitor user template.
      - `modified` string, date-time — The last modified timestamp. When the template version was created.
      - `monitor_definition` object — A valid monitor definition in the same format as the [V1 Monitor API](https://docs.datadoghq.com/api/latest/monitors/#create-a-monitor).
      - `tags` string[] — The definition of `MonitorUserTemplateTags` object.
      - `template_variables` MonitorUserTemplateTemplateVariablesItems[] — The definition of `MonitorUserTemplateTemplateVariables` object.
        - `available_values` string[] — Available values for the variable.
        - `defaults` string[] — Default values of the template variable.
        - `name` string, required — The name of the template variable.
        - `tag_key` string — The tag key associated with the variable. This works the same as dashboard template variables.
      - `title` string — The title of the monitor user template.
      - `version` integer, nullable — The version of the monitor user template.
      - `versions` SimpleMonitorUserTemplate[] — All versions of the monitor user template.
        - `created` string, date-time — The created timestamp of the template.
        - `description` string, nullable — A brief description of the monitor user template.
        - `id` string — The unique identifier. The initial version will match the template ID.
        - `monitor_definition` object — A valid monitor definition in the same format as the [V1 Monitor API](https://docs.datadoghq.com/api/latest/monitors/#create-a-monitor).
        - `tags` string[] — The definition of `MonitorUserTemplateTags` object.
        - `template_variables` MonitorUserTemplateTemplateVariablesItems[] — The definition of `MonitorUserTemplateTemplateVariables` object.
          - `available_values` string[] — Available values for the variable.
          - `defaults` string[] — Default values of the template variable.
          - `name` string, required — The name of the template variable.
          - `tag_key` string — The tag key associated with the variable. This works the same as dashboard template variables.
        - `title` string — The title of the monitor user template.
        - `version` integer, nullable — The version of the monitor user template.
    - `id` string — The unique identifier.
    - `type` 'monitor-user-template' — Monitor user template resource type.

## Other responses

- `400` — Bad Request
- `404` — Not Found
- `429` — Too many requests

---

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