---
title: "Update dynamic field"
method: PUT
path: "/documents/{document}/dynamic-fields/{dynamicField}"
tags: ["Document Operations"]
---

# Update dynamic field

`PUT /documents/{document}/dynamic-fields/{dynamicField}`

<small>Requires an API token with the **Document Manager** role.</small>

Updates the value of a [dynamic field](/#dynamic-fields) for a [document](/#documents).

> Alternatively: if your use case involves updating multiple dynamic fields, and you have all the new values
> available at once, the [bulk update dynamic fields](/operations/v1.documents.dynamic-fields.bulk-update) request
> is likely to be a better fit.

## Value format

The content of the `value` parameter depends on the `type` of the dynamic field. The table below lists the
available types and shows how values of each type should be sent.

| Descriptive name | API `type` | Example values | Description |
|------------------|------------|----------------|-------------|
| Email | `email` | `"user@example.com"` | An email address. |
| Number | `number` | `1234.56` | A numeric value. |
| Currency | `currency` | `"EUR;1234.56"`, `"EUR;1234"` | A string containing a currency code and numeric value concatenated with a semicolon. |
| Currency over time | `currency_duration` | `"EUR;1234.56;monthly"`, `"EUR;123456;yearly"` | A string containing a currency code, numeric value and period (one of `monthly` or `yearly`) concatenated with a semicolon. |
| Select | `select` | `"Blue"` | One of the values from the field's `select_values` list. |
| Multi-select | `multi_select` | `["Red","Blue"]` | Array containing one or more values from the field's `select_values` list. |
| Date | `date` | `"2025-12-31"` | A date in the format "YYYY-MM-DD". |
| Yes / No | `bool` | `true`, `false` | A boolean value. |
| Duration | `duration` | `"P6D"` (6 days), `"P2W"` (2 weeks), `"PT12H"` (12 hours) | A string containing a [duration specification](https://www.php.net/manual/en/dateinterval.construct.php). |
| Text | `text` | `"Vienna"` | Up to 4096 characters of text. |
| Multi-line text | `textarea` | `"Another text value"` | Up to 4096 characters of text. |

## Path parameters

- `document` string, required
- `dynamicField` string, required

## Request body

- object
  - `value` union — The new value for the field
    - unknown[]
      - unknown
    - boolean
    - string

## Response `200`

`DynamicFieldResource`

- object
  - `data` DynamicFieldResource, required
    - `uuid` string, required
    - `ref_uuid` string, required — A static reference identifier, allowing dynamic fields in documents to be matched their corresponding field in the document's source template.
    - `type` 'id' | 'uuid' | 'bool' | 'date' | 'duration' | 'email' | 'list' | 'number' | 'currency' | 'currency_duration' | 'clause' | 'select' | 'multi_select' | 'text' | 'textarea' | 'timestamp' | 'array' | 'enum', required
    - `name` string, required
    - `scope` 'internal' | 'internal_and_external', required
    - `settings` MultiFieldSettingsResource, required
      - `currencies` string[], required — For `currency` or `currency_duration` fields, defines the currencies that can be assigned to the field's values
    - `autofill_type` 'document_created_date' | 'document_review_date' | 'document_signing_date', required
    - `format` DynamicFieldFormatResource, required
      - `decimals` integer, required
      - `decimal_separator` string, required
      - `thousands_separator` string, required
    - `select_values` string[], nullable, required — When `type` is "select" or "multi_select", defines the possible values for `value`
    - `is_mandatory` boolean, required
    - `question` string, nullable, required
    - `question_external` string, nullable, required — Question variant for external users
    - `value` union, required — The field's value, if it has been set
      - string
      - boolean
      - unknown[]
        - unknown
    - `order` integer, nullable, required

## Other responses

- `401` — Unauthenticated
- `403` — Authorization error
- `404` — Not found
- `422` — Validation error

---

[API](https://skmtc.dev/fynk/apis/fynk-api-reference.md) · [All operations](https://skmtc.dev/fynk/apis/fynk-api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/fynk/fynk-api-reference/revisions/9657a6757f59/schema)