---
title: "Patch Conversation Endpoint"
method: PATCH
path: "/api/v1/remy/conversations/{conversation_id}"
tags: ["remy", "remy"]
---

# Patch Conversation Endpoint

`PATCH /api/v1/remy/conversations/{conversation_id}`

Update status and/or agreed price; the campaign's total_spent is re-derived from closed deals.

## Path parameters

- `conversation_id` string, required

## Request body

- PatchConversationRequestDTO
  - `status` 'contacted' | 'negotiating' | 'closed' | 'rejected' — Four stable states — legacy's fifth value ("replied") was a transient step that its own auto-advance logic immediately overwrote with "negotiating" on the same call, so it never actually persisted as a stable state. Not carried over here.
  - `agreed_price` number, nullable

## Response `200`

Successful Response

- ConversationDetailDTO
  - `id` string, required
  - `creator_id` string, required
  - `platform` string, required
  - `channel` string, required
  - `status` string, required
  - `agreed_price` number, nullable
  - `handle` string, nullable
  - `display_name` string, nullable
  - `profile_pic_url` string, nullable
  - `followers` integer, nullable
  - `last_message_at` string, date-time, nullable
  - `last_message_preview` string, nullable
  - `last_message_role` string, nullable
  - `campaign_id` string, required
  - `messages` MessageDTO[]
    - `id` string, required
    - `role` string, required
    - `content` string, nullable
    - `channel` string, required
    - `sending_account_id` string, nullable
    - `provider_message_id` string, nullable
    - `sent_at` string, date-time, nullable

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/brandbooster/apis/fastapi.md) · [All operations](https://skmtc.dev/brandbooster/apis/fastapi/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/brandbooster/fastapi/revisions/ff7f2b621b41/schema)