---
title: "Draft a message for a dating conversation"
method: POST
path: "/api/v1/contacts/{id}/suggest-message"
---

# Draft a message for a dating conversation

`POST /api/v1/contacts/{id}/suggest-message`

## Request

- Base URL: `https://memchats.com`
- URL: `https://memchats.com/api/v1/contacts/{id}/suggest-message`
- Auth: HTTP bearer

Costs a model call. Combines her profile with the user's voice profile. First contact is capped at 140 characters (the Tinder limit); an open conversation removes the cap. Without `history` (or with an empty one) the server uses the last 40 stored messages of this contact. With `correction` ("Muy light", "Más corto"...) the correction is appended to the dating voice profile exactly as POST /voice-profile does (creating the profile from the default voice when there is none) and the draft is regenerated obeying it. Requires a dating profile: without one, a personalised message is a generic line with her name in it.

## Path parameters

- `id` integer, required

## Request body

- object
  - `intent` 'open' | 'reply' | 'revive' | 'propose_date'
  - `charLimitOverride` integer, nullable
  - `history` object[]
    - `from` 'me' | 'her', required
    - `text` string, required
  - `correction` string, nullable

## Response `200`

The draft, the situation, open plans, the language chosen, the limit applied and why

- object
  - `suggestion` object
    - `text` string
    - `situation` string
    - `openPlans` string[]
    - `language` string
    - `charLimit` integer, nullable
    - `rationale` string
    - `variants` object[], nullable: 2 or 3 drafts of distinct tone written in the same model call (2026-10-05), each within `charLimit`; the first one equals `text`. Absent or null when the model gave only one.
      - `text` string
      - `tone` 'direct' | 'playful' | 'curious'

## Other responses

- `400`: Invalid request
- `404`: Contact not found
- `409`: No dating profile for this contact yet

---

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