Skip to main content
​
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

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

​
Response

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