---
title: "Update a document template"
method: PUT
path: "/fleetify/document_templates/{id}"
tags: ["Dispatches_Documents"]
---

# Update a document template

`PUT /fleetify/document_templates/{id}`

## Query parameters

- `key` string, required

## Request body

- object
  - `name` string — Specify the document template name to be updated.
  - `content` DocumentTemplateContentRequest[] — An object to collect the details of form fields to be updated - data structures, validation rules. Please note that the details provided here will overwrite any existing document fields in the given template.
    - `label` string, required — Specify the label or the name of the field. The label specified here can be used as field name when rendering the document in the Driver app.
    - `name` string — Specify the name of the document field. A field'sname can be used for internal references to the document field.
    - `type` 'string' | 'number' | 'date_time' | 'photos' | 'multi_choices' | 'signature' | 'barcode' | 'single_choice', required — Specify the data type of the field. It corresponds to the type of information that the driver needs to collect.
    - `required` boolean — Specify if it is mandatory to fill the field. Default value is false.
    - `validation` object — Specify the validation rules for the field. This can be used to enforce data quality and integrity checks. For example, if the field is a number type, validation can define constraints like minimum / maximum number values.
      - `min` integer — Specifies the minimum allowed value for number type document field. Input values must be greater than or equal to this threshold.
      - `max` integer — Specifies the maximum allowed value for number type document field. Input values must be less than or equal to this threshold.
      - `min_items` integer — Specifies the minimum number of items for multi_choices, photos type document fields. The number of provided input items must be greater than or equal to this threshold.
      - `max_items` integer — Specifies the maximum number of items for multi_choices, photos type document fields. The number of provided input items must be less than or equal to this threshold.
    - `meta` object — An object to define additional information required for single_choice or multi_choices type document items.
      - `options` object[], required — An array of objects to define options for a multi_choices or single_choice type document field. Each object represents one option.
        - `label` string, required — Specify the label or name for the option.
        - `value` string, required — Specify the value associated with the option. This value will be submitted when the option is checked in the Driver app.

## Response `200`

- object
  - `status` integer — Returns the HTTP response code.
  - `msg` string — Returns the error message in case of a failed request. If the request is successful, this field is not present in the response.
  - `data` object — An object returning the details of the updated document template.
    - `id` string — Returns the unique ID of the document template.
    - `name` string — Returns the updated name of the document template.
    - `content` DocumentTemplateContentResponse[] — An array of object returning the details of updated data structures and validation rules for document fields. Each object represents one document field.
      - `label` string — Returns the label of the document field.
      - `name` string — Returns the name of the document field.
      - `type` string — Returns the data type of the document field. It will always belong to one of string, number, date_time, photos, multi_choices, signature, barcode, and single_choice.
      - `required` boolean — Indicates if the document field is mandatory or not.
      - `validation` object — Returns the validation rules for number , multi_choices , and photos document field types.
        - `min` integer — Returns the minimum allowed value for number type document item, as specified at the time of configuring the field. This parameter is not present in the response if it was not provided in the input.
        - `max` integer — Returns the maximum allowed value for number type document item, as specified at the time of configuring the field. This parameter is not present in the response if it was not provided in the input.
        - `min_items` string — Returns the minimum number of items required for multi_choices, photos type document items. This parameter will not be present in the response if it was not provided in the input.
        - `max_items` string — Returns the maximum number of items required for multi_choices, photos type document items. This parameter will not be present in the response if it was not provided in the input.
      - `meta` object — Returns the options configured for single_choice or multi_choices type document items.
        - `options` object[] — An array of objects returning the options for multi_choices or single_choice type document field. Each object represents one configured option.
          - `label` string — Returns the label for the option.
          - `value` string — Returns the value associated with the option. This value gets submitted when the option is checked in the Driver app.

---

[API](https://skmtc.net/nextbillion-ai/apis/one-spec-service.md) · [All operations](https://skmtc.net/nextbillion-ai/apis/one-spec-service/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/nextbillion-ai/one-spec-service/versions/b647f1808dda/schema)