Skip to main content
POST
/
v1
/
dev
/
user
/
conversations
/
from-segments
Create conversation from transcript segments
curl --request POST \
  --url https://api.omi.me/v1/dev/user/conversations/from-segments \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data @- <<EOF
{
  "transcript_segments": [
    {
      "text": "Let's review the quarterly results",
      "speaker": "SPEAKER_00",
      "is_user": true,
      "start": 0,
      "end": 3.5
    },
    {
      "text": "Revenue is up 25% from last quarter",
      "speaker": "SPEAKER_01",
      "is_user": false,
      "start": 4,
      "end": 7.2
    }
  ],
  "source": "phone",
  "language": "en"
}
EOF
{
  "id": "conv_789",
  "status": "completed",
  "discarded": false
}

Authorizations

Authorization
string
header
required

Developer API key. Get one from Settings → Developer → Create Key in the Omi app. Keys are prefixed with omi_dev_.

Body

application/json
transcript_segments
object[]
required

List of transcript segments (1–500).

Required array length: 1 - 500 elements
source
string
default:external_integration

Source of conversation.

started_at
string<date-time>

When conversation started.

finished_at
string<date-time>

When conversation finished.

language
string
default:en

Language code.

geolocation
object

Response

Conversation created.

id
string

Conversation ID.

status
string

Processing status.

discarded
boolean

Whether the conversation was discarded.