> ## Documentation Index
> Fetch the complete documentation index at: https://docs.vouchmark.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Update widget

> Update a widget's name or configuration.

Updates a widget's `name`, `config`, or both. Only the fields you send are applied. When `config` is sent it must be a complete, valid configuration object (same shape as [Create widget](/api-reference/onboarding/create-widget)). Returns the full updated widget.

Requires `Authorization: Bearer $TOKEN`.

## Path parameters

<ParamField path="id" type="string" required>
  The widget ID.
</ParamField>

## Body

<ParamField body="name" type="string">
  New display name. 1–120 characters.
</ParamField>

<ParamField body="config" type="object">
  Full widget configuration object — see [Create widget](/api-reference/onboarding/create-widget) for every section and sub-field.
</ParamField>

<RequestExample>
  ```bash cURL theme={null}
  curl -X PATCH https://api.vouchmark.com/v1/kyb/widgets/wgt_aBcD... \
    -H "Authorization: Bearer $TOKEN" \
    -H "Content-Type: application/json" \
    -d '{
      "name": "Acme KYB v2"
    }'
  ```
</RequestExample>

<ResponseExample>
  ```json theme={null}
  {
    "success": true,
    "data": {
      "id": "wgt_aBcD...",
      "name": "Acme KYB v2",
      "status": "live",
      "environment": "live",
      "templateId": "fintech",
      "config": { "branding": { "...": "..." }, "modules": { "...": "..." }, "flow": { "...": "..." }, "security": { "...": "..." }, "risk": { "...": "..." }, "notifications": { "...": "..." } },
      "embedLinkToken": "elt_...",
      "createdAt": "2026-06-01T10:00:00Z",
      "updatedAt": "2026-06-01T10:05:00Z"
    }
  }
  ```
</ResponseExample>