v24

latestOpenAPI 3.1.0MITraw.githubusercontent.com2026-08-012843108.3 KB
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/{id} to retrieve full details
post/v1/dev/user/conversations

Request body

finished_atstring date-time nullable

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

languagestring nullable

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

started_atstring date-time nullable

When the conversation started (defaults to now)

textstring required

The conversation text/transcript

text_source'audio_transcript' | 'message' | 'other_text'
text_source_specstring nullable

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

Response

Successful Response

discardedboolean required
idstring required
statusstring required