---
title: "Update a dialect"
method: PUT
path: "/v1/dialects/{id}"
tags: ["Schemas"]
---

# Update a dialect

`PUT /v1/dialects/{id}`

## Request

- Base URL: `https://api.talonic.com`
- URL: `https://api.talonic.com/v1/dialects/{id}`
- Auth: HTTP bearer

Partial update. Only the keys present on the body are patched. Bumps the stored `version`.

## Path parameters

- `id` string, uuid, required

## Request body

- DialectUpdateRequest: Partial update — only supplied keys are patched.
  - `name` string
  - `date_format` string
  - `number_locale` string
  - `delimiter` string
  - `null_representation` string
  - `encoding` string
  - `boolean_format` string[]

## Response `200`

Dialect updated.

- DialectResponse
  - `id` string, uuid, required
  - `name` string, required
  - `version` integer: Monotonically increasing version counter. Bumped on every update.
  - `config` DialectConfig: Dialect configuration payload; all keys optional.
    - `date_format` string: Date format pattern (e.g. `YYYY-MM-DD`, `DD/MM/YYYY`).
    - `number_locale` string: BCP-47 locale tag used for number formatting.
    - `delimiter` string: CSV column delimiter character.
    - `null_representation` string: How null values are rendered in serialised output.
    - `encoding` string: Character encoding label (e.g. `UTF-8`, `ISO-8859-1`).
    - `boolean_format` string[]: Exactly 2 strings — `[true_value, false_value]`.
  - `created_at` string, date-time
  - `updated_at` string, date-time, nullable
  - `links` object
    - `self` string

## Other responses

- `400`: The request is invalid.
- `401`: Missing or invalid API key.
- `404`: The requested resource was not found.
- `429`: Daily rate limit exceeded.

---

[API](https://skmtc.dev/talonic/apis/talonic-api.md) · [All operations](https://skmtc.dev/talonic/apis/talonic-api/llms.txt) · [OpenAPI document](https://skmtc.dev/talonic/apis/talonic-api/revisions/678fe5f8c9c3?raw)