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

# Update Conversation Endpoint

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

Update a conversation's title or discard status.

- **conversation_id**: The ID of the conversation to update
- **title**: New title for the conversation (optional)
- **discarded**: Whether the conversation is discarded (optional)

## Path parameters

- `conversation_id` string, required

## Request body

- UpdateConversationRequest
  - `discarded` boolean, nullable — Whether the conversation is discarded
  - `title` string, nullable — New title for the conversation

## Response `200`

Successful Response

- DeveloperConversation
  - `created_at` string, date-time, required
  - `finished_at` string, date-time, nullable, required
  - `folder_id` string, nullable
  - `folder_name` string, nullable
  - `geolocation` Geolocation
    - `address` string, nullable
    - `google_place_id` string, nullable
    - `latitude` number, required
    - `location_type` string, nullable
    - `longitude` number, required
  - `id` string, required
  - `language` string, nullable
  - `source` string, nullable
  - `started_at` string, date-time, nullable, required
  - `structured` DeveloperConversationStructured, required
    - `action_items` DeveloperConversationActionItem[]
      - `completed` boolean
      - `completed_at` string, date-time, nullable
      - `conversation_id` string, nullable
      - `created_at` string, date-time, nullable
      - `description` string, required
      - `due_at` string, date-time, nullable
      - `updated_at` string, date-time, nullable
    - `category` 'personal' | 'education' | 'health' | 'finance' | 'legal' | 'philosophy' | 'spiritual' | 'science' | 'entrepreneurship' | 'parenting' | 'romantic' | 'travel' | 'inspiration' | 'technology' | 'business' | 'social' | 'work' | 'sports' | 'politics' | 'literature' | 'history' | 'architecture' | 'music' | 'weather' | 'news' | 'entertainment' | 'psychology' | 'real' | 'design' | 'family' | 'economics' | 'environment' | 'other', required
    - `emoji` string
    - `events` DeveloperConversationEvent[]
      - `created` boolean
      - `description` string
      - `duration` integer
      - `start` string, date-time, required
      - `title` string, required
    - `overview` string, required
    - `title` string, required
  - `transcript_segments` DeveloperTranscriptSegment[], nullable
    - `end` number, required
    - `id` string, nullable
    - `speaker_id` integer, nullable
    - `speaker_name` string, nullable
    - `start` number, required
    - `text` string, required

## Other responses

- `401` — Missing or invalid authentication credentials.
- `403` — Authenticated, but the token does not grant the required scope.
- `404` — Requested resource was not found.
- `422` — Validation Error

## Changes

> 28 revisions in range; 3 could not be searched.

- **2026-06-30** `fbfe4956e141` — 2 warning
  - removed the optional property `detail/items/ctx` from the response with the `422` status
  - removed the optional property `detail/items/input` from the response with the `422` status
- **2026-06-30** `c2ab717efdbc` — 2 info
  - added the optional property `detail/items/ctx` to the response with the `422` status
  - added the optional property `detail/items/input` to the response with the `422` status
- **2026-06-30** `fbfe4956e141` — 2 warning
  - removed the optional property `detail/items/ctx` from the response with the `422` status
  - removed the optional property `detail/items/input` from the response with the `422` status
- **2026-06-30** `c2ab717efdbc` — 2 info
  - added the optional property `detail/items/ctx` to the response with the `422` status
  - added the optional property `detail/items/input` to the response with the `422` status
- **2026-06-30** `fbfe4956e141` — 2 warning
  - removed the optional property `detail/items/ctx` from the response with the `422` status
  - removed the optional property `detail/items/input` from the response with the `422` status

[Full 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/3add0ce9bc4f/schema)