---
title: "Diacritize Text"
method: POST
path: "/v1/diacritics"
---

# Diacritize Text

`POST /v1/diacritics`

Add appropriate tone marks to text.

## Headers

- `X-Data-Retention` boolean

## Request body

- DiacriticsRequest
  - `language` string, required — Only Yoruba is supported at the moment.
  - `text` string, required

## Response `200`

Successful Response

- DiacriticsResponse
  - `request_id` string, uuid, required
  - `text` string, required

## Changes

- **2026-04-30** `345ddd9a88d1` — 6 breaking, 2 info
  - removed the enum value `am` of the request property `language`
  - removed the enum value `en` of the request property `language`
  - removed the enum value `ha` of the request property `language`
  - removed the enum value `ig` of the request property `language`
  - …4 more
- **2026-01-21** `9caec45089fb` — 5 info
  - api operation id `tone_mark_v1_diacritics_post` removed and replaced with `diacritizeText`
  - the endpoint scheme security `ApiKeyAuth` was removed from the API
  - api tag `Diacritics` added
  - added the new `pcm` enum value to the request property `language`
  - …1 more
- **2025-08-05** `5e0436ccb10d` — 2 info
  - the endpoint scheme security `ApiKeyAuth` was added to the API
  - the endpoint scheme security `OAuth2PasswordBearer` was removed from the API
- **2025-08-01** `2ca8a3d6f0d9` — 1 breaking, 2 info
  - the response's body type/format changed from ``/`` to `object`/`` for status `200`
  - added the required property `request_id` to the response with the `200` status
  - added the required property `text` to the response with the `200` status

[Change history](https://skmtc.dev/spi-tch/apis/spitch-api/changes/v1/diacritics/post.md)

---

[API](https://skmtc.dev/spi-tch/apis/spitch-api.md) · [All operations](https://skmtc.dev/spi-tch/apis/spitch-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/spi-tch/spitch-api/revisions/345ddd9a88d1/schema)