Skip to main content
​
method
POST
/api/sessions/upload
Creates or updates the session and returns signed upload URLs for media files. Auth: Agent key or User JWT + X-Team-Id

​
Request body

​
session_id
string
Existing session ID to update (omit to create)
​
title
string
required
Session title
​
description
string
Session description
​
duration_seconds
number
Recording duration
​
timeline
object[]
Timeline events
​
notes
object
Tiptap notes content
​
generated_notes
string
AI-generated notes
​
files
object
File flags (has_video, has_audio, has_thumbnail, attachments)

​
Response

​
session_id
string
required
The session ID
​
created
boolean
required
Whether a new session was created
​
upload_urls
object
Signed URLs for file upload