POST /v1/core/text-truncate
Truncate text
Cut to a length without slicing a word in half, with an ellipsis added where it makes sense.
Shorten text to a length now No key, no code — 1 credit either way.
curl -X POST "$DOATHING_API/v1/core/text-truncate" \
-H "x-api-key: $DOATHING_KEY" \
-H "content-type: application/json" \
-d '{"text": "The quick brown fox", "options": {"length": 12}}'
Cut to a length without slicing a word in half, with an ellipsis added where it makes sense.
Truncate text to a character or word budget on a word, sentence or character boundary.
Input
Send either a text string or a file object. A file is decoded as UTF-8 and must be one of text/plain, text/markdown, text/html, text/csv.
Response
The result carries your remaining balance alongside it, so you can track spend without a second call.
{
"text": "The quick…",
"truncated": true,
"length": 10,
"request_id": "37f01edb-0163-42a1-ac51-0acaef979800",
"credits_remaining": 96
}
Cost
1 credit per call, whether it is run from the site or from the API — the credential differs, the price does not. A new account starts with 20 credits.
A rejected request still costs a credit: the authorizer decrements before the tool validates. A call rejected for a missing or invalid key is free.
Parameters
Generated from the endpoint’s own validation, so this is exactly what it accepts. A body field goes at the top level; an option goes inside options.
| Name | In | Type | Default | Notes |
|---|---|---|---|---|
| boundary | options | string | "word" | word, sentence or character. one of word, sentence, character |
| length | options | integer | 100 | Maximum length of the result, suffix included. 1 to 1000000 |
| suffix | options | string | "…" | Appended when the text was cut. Defaults to an ellipsis. |