# Preview an AI-composed message

### Preview an AI-composed message

`POST /api/v1/compose`

Operation ID: `composePreview`

**Request body** (required)

- `channel` ("linkedin" | "instagram", required)
- `connectedAccountId` (string · uuid, required)
- `identity` (string, required)
- `prompt` (string, required)
- `context` ("profile" | "posts" | "conversation" | "lead_properties"[], optional)
- `model` (string, optional)
- `maxChars` (integer, optional)
- `leadProperties` (object, optional)

**200**: Generated text and compose metadata.

- `text` (string, required)
- `meta` (object, required)
  - `model` (string, required)
  - `contextUsed` (object[], required)
  - `usedFallback` (boolean, required)
  - `generatedAt` (string · date-time, required)
- `providerCalls` (integer, required)
- `remainingBudget` (object, required)

**Errors**

- `400`: Bad request
- `401`: Unauthorized: missing or invalid API key
- `403`: Forbidden
- `404`: Not found
- `422`: Invalid request payload