---
title: "Create conversation from transcript segments"
method: POST
path: "/v1/dev/user/conversations/from-segments"
tags: ["Conversations"]
---

# Create conversation from transcript segments

`POST /v1/dev/user/conversations/from-segments`

Create a conversation from structured transcript segments with speaker diarization. Unlike text-based conversations, transcript segments are stored and can be retrieved with `include_transcript=true`.

## Request body

- CreateConversationFromSegments
  - `transcript_segments` TranscriptSegmentInput[], required — List of transcript segments (1–500).
    - `text` string, required — The spoken text.
    - `speaker` string — Speaker identifier (e.g. `SPEAKER_00`).
    - `speaker_id` integer — Numeric speaker ID.
    - `is_user` boolean — Whether this segment is from the user.
    - `person_id` string — ID of known person speaking.
    - `start` number, required — Start time in seconds.
    - `end` number, required — End time in seconds.
  - `source` string — Source of conversation.
  - `started_at` string, date-time — When conversation started.
  - `finished_at` string, date-time — When conversation finished.
  - `language` string — Language code.
  - `geolocation` GeolocationInput
    - `latitude` number
    - `longitude` number

## Response `200`

Conversation created.

- ConversationResponse
  - `id` string — Conversation ID.
  - `status` string — Processing status.
  - `discarded` boolean — Whether the conversation was discarded.

## Other responses

- `401` — Invalid or missing API key.
- `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/from-segments/post.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)