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
Response
Successful Response