Create Conversation

curl --request POST \
  --url https://api.omi.me/v1/dev/user/conversations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "text": "<string>",
  "finished_at": "2023-11-07T05:31:56Z",
  "geolocation": {
    "latitude": 123,
    "longitude": 123,
    "address": "<string>",
    "google_place_id": "<string>",
    "location_type": "<string>"
  },
  "language": "en",
  "started_at": "2023-11-07T05:31:56Z",
  "text_source": "other_text",
  "text_source_spec": "<string>"
}
'

{
  "discarded": true,
  "id": "<string>",
  "status": "<string>"
}

Conversations

Create Conversation

Create a new conversation from text for the authenticated user.

This endpoint processes the provided text through the full conversation pipeline:

Generates structured data (title, overview, category, emoji)
Extracts action items (with deduplication)
Extracts memories (with quality filtering)
Determines if conversation should be discarded
Triggers app integrations
Triggers webhooks

Request Parameters:

text: The conversation text/transcript (1-100,000 characters)
text_source: Source type - audio_transcript, message, or other_text (default: other_text)
text_source_spec: Additional source info (e.g., ‘email’, ‘slack’)
started_at: When conversation started (defaults to now)
finished_at: When conversation finished (defaults to started_at + 5 minutes)
language: Language code (default: ‘en’)
geolocation: Optional geolocation data

Response:

Returns the created conversation ID and status
Use GET /v1/dev/user/conversations/ to retrieve full details

POST

dev

user

conversations

Create Conversation

curl --request POST \
  --url https://api.omi.me/v1/dev/user/conversations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "text": "<string>",
  "finished_at": "2023-11-07T05:31:56Z",
  "geolocation": {
    "latitude": 123,
    "longitude": 123,
    "address": "<string>",
    "google_place_id": "<string>",
    "location_type": "<string>"
  },
  "language": "en",
  "started_at": "2023-11-07T05:31:56Z",
  "text_source": "other_text",
  "text_source_spec": "<string>"
}
'

{
  "discarded": true,
  "id": "<string>",
  "status": "<string>"
}

Authorizations

Authorization

string

header

required

Send Authorization: Bearer <omi_developer_api_key>.

Body

application/json

text

string

required

The conversation text/transcript

Required string length: 1 - 100000

finished_at

string<date-time> | null

When the conversation finished (defaults to started_at + 5 minutes)

geolocation

Geolocation · object

Geolocation where conversation occurred

Show child attributes

language

string | null

default:en

Language code (ISO 639-1, e.g., 'en', 'es', 'fr')

started_at

string<date-time> | null

When the conversation started (defaults to now)

text_source

enum<string>

default:other_text

Source type: audio_transcript, message, or other_text

Available options:

audio_transcript,

message,

other_text

text_source_spec

string | null

Additional source specification (e.g., 'email', 'slack', 'whatsapp')

Response

Successful Response

discarded

boolean

required

string

required

status

string

required

Get Conversations Create Conversation From Segments

⌘I