---
title: "Suggest Message"
method: POST
path: "/conversations/{conversation_id}/suggest-message"
tags: ["conversations"]
---

# Suggest Message

`POST /conversations/{conversation_id}/suggest-message`

Generate AI-suggested message for technician to send to customer.

This endpoint:
1. Fetches conversation details including followup data (job/estimates)
2. Fetches conversation history (messages)
3. Uses FollowUpMessageGenerator to create a contextual message suggestion
4. Returns the suggested message text for technician to review and edit

The AI considers:
- Job/estimate details (what work was done)
- Conversation history (what's been discussed)
- Conversation state (initial outreach vs reply)

## Path parameters

- `conversation_id` string, uuid, required

## Response `200`

Successful Response

- SuggestMessageResponse — Response model for message suggestion.
  - `suggested_message` string, required

## Other responses

- `404` — Not found
- `422` — Validation Error

---

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