---
title: "Update conversation"
method: PATCH
path: "/v1/dev/user/conversations/{conversation_id}"
tags: ["Conversations"]
---

# Update conversation

`PATCH /v1/dev/user/conversations/{conversation_id}`

Update a conversation's title or discard status. At least one field must be provided.

## Path parameters

- `conversation_id` string, required

## Request body

- UpdateConversation
  - `title` string — New title.
  - `discarded` boolean — Whether the conversation is discarded.

## Response `200`

The updated conversation.

- Conversation
  - `id` string — Unique identifier.
  - `created_at` string, date-time — When the conversation record was created.
  - `started_at` string, date-time — When the conversation started.
  - `finished_at` string, date-time — When the conversation ended.
  - `language` string — Language code (e.g. `en`).
  - `source` string — Source device or app.
  - `structured` StructuredData
    - `title` string — AI-generated title.
    - `overview` string — Summary of the conversation.
    - `emoji` string — Representative emoji.
    - `category` string — Category (work, personal, etc.).
    - `action_items` ActionItemSummary[]
      - `description` string
      - `completed` boolean
      - `created_at` string, date-time
      - `updated_at` string, date-time
      - `due_at` string, date-time, nullable
      - `completed_at` string, date-time, nullable
    - `events` object[]
  - `transcript_segments` TranscriptSegment[] — Transcript segments (only present when `include_transcript=true`).
    - `id` string — Segment identifier.
    - `text` string — The transcribed text.
    - `speaker_id` integer — Numeric speaker identifier.
    - `speaker_name` string — Human-readable speaker name.
    - `start` number — Start timestamp in seconds.
    - `end` number — End timestamp in seconds.
  - `geolocation` Geolocation
    - `latitude` number
    - `longitude` number
    - `address` string
    - `google_place_id` string
    - `location_type` string

## Other responses

- `401` — Invalid or missing API key.
- `404` — Resource not found.
- `422` — Validation error.

## Changes

- **2026-03-24** `b791dc93aa91` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/basedhardware/apis/omi-developer-api/changes/v1/dev/user/conversations/:conversation_id/patch.md)

---

[API](https://skmtc.dev/basedhardware/apis/omi-developer-api.md) · [All operations](https://skmtc.dev/basedhardware/apis/omi-developer-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/basedhardware/omi-developer-api/revisions/b791dc93aa91/schema)