Document Operations

Bulk update dynamic fields

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

PUT

/documents/{document}/dynamic-fields

curl --request PUT \
  --url https://app.fynk.com/v1/api/documents/{document}/dynamic-fields \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "values": {
    "My Text Field": "Vienna",
    "a1b2c3d4-e5f6-7890-abcd-ef1234567890": "EUR;95000;yearly"
  }
}
'

{
  "data": [
    {
      "autofill_type": "document_created_date",
      "format": {
        "decimal_separator": ".",
        "decimals": 2,
        "thousands_separator": ","
      },
      "is_mandatory": true,
      "name": "Gross salary",
      "order": 123,
      "question": "What is the employee's gross salary in EUR?",
      "question_external": "<string>",
      "ref_uuid": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "scope": "internal",
      "select_values": [
        "<string>"
      ],
      "settings": {
        "currencies": [
          "EUR",
          "USD"
        ]
      },
      "type": "id",
      "uuid": "7dae3dad-e56d-45e9-86e5-b69dc30597dc",
      "value": "EUR;95000;yearly"
    }
  ]
}

Updates the value of one or more dynamic fields for a document.

The values parameter should be an object with up to 20 entries whose keys identify the document's dynamic fields and whose values are the new values to set. Valid identifiers to use as keys are a dynamic field's uuid, ref_uuid or name. Values should follow the same rules as described for the update dynamic field request.

Returns the dynamic fields that were changed by the request.

Authorizations

Authorizationstringheaderrequired

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

documentstringrequired

The document UUID

Body

valuesobjectrequired

New values for up to 20 of the document's dynamic fields. Each key must identify a dynamic field on the document - by either its ref_uuid, uuid or name. Values expect the same format as the Update dynamic field endpoint.

Response

Array of DynamicFieldResource

dataobject[]required

Show child attributes

Still need help? Share an idea