Schemas

Create a dialect

Create a new shared dialect.

post/v1/dialects

Request

  • Base URL: https://api.talonic.com
  • URL: https://api.talonic.com/v1/dialects
  • Auth: HTTP bearer

Request body

namestring required

Dialect name. Required, non-empty.

date_formatstring

Date format string (e.g. YYYY-MM-DD, DD/MM/YYYY).

number_localestring

BCP-47 locale for number formatting.

delimiterstring

CSV delimiter character.

null_representationstring

Representation of null values.

encodingstring

Character encoding.

boolean_formatstring[]

Exactly 2 strings — [true_value, false_value].

Example request

{
  "name": "European CSV",
  "boolean_format": [
    "Yes",
    "No"
  ]
}

Response

Dialect created (alias of 201).

idstring uuid required
namestring required
versioninteger

Monotonically increasing version counter. Bumped on every update.

created_atstring date-time
updated_atstring date-time nullable

Example response

{
  "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "name": "European CSV",
  "version": 1,
  "config": {
    "date_format": "YYYY-MM-DD",
    "number_locale": "en-US",
    "delimiter": ",",
    "encoding": "UTF-8",
    "boolean_format": [
      "true",
      "false"
    ]
  },
  "created_at": "2026-04-25T14:30:00.000Z",
  "updated_at": "2026-04-25T14:30:00.000Z"
}

Changes

No recorded changes to this operation across all 1 revision of this API.