---
title: "Preview Message"
method: POST
path: "/v1/messages/preview"
---

# Preview Message

`POST /v1/messages/preview`

## Request

- Base URL: `https://api.textforagents.com`
- URL: `https://api.textforagents.com/v1/messages/preview`
- Auth: none declared

Phase 8a: segment preview for a draft message — encoding,
segment count, and what optimize=true would send instead.
Read-only: no message row, no ledger entry, no provider
call, so it is safe to call on every draft.

## Headers

- `authorization` string, nullable

## Request body

- PreviewMessage
  - `text` string, required

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

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