---
title: "Tone Mark"
method: POST
path: "/v1/diacritics"
---

# Tone Mark

`POST /v1/diacritics`

## Request body

- ToneMark — Tone marking (diacritics) task model. Defines parameters for adding diacritical marks to text in languages that use tone markings.
  - `language` 'yo' | 'en' | 'ha' | 'ig' | 'am', required
  - `text` string, required

## Response `200`

Successful Response

- Diacritics — Response model for text diacritization requests. Attributes: request_id: Unique identifier for the diacritization request text: Text with added diacritical marks for proper pronunciation language: Language code for the diacritized text
  - `request_id` string, uuid, required
  - `text` string, required

## Other responses

- `422` — Validation Error

## Changes

- **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 changed from no type 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/b384c3db1a21/schema)