Skip to main content
POST
Start an operator conversation

Authorizations

Authorization
string
header
required

A Cool Computers API key, user access token, or claimed agent access token in the Authorization header. Follow https://www.cool.computer/auth.md for agent registration and https://www.cool.computer/authentication.md for direct user credentials.

Body

application/json
turn_id
string
required
Pattern: ^opt_[A-Za-z0-9_-]{24}$
title
string
required

The conversation title; blank or whitespace-only titles are refused with 400.

Required string length: 1 - 200
Pattern: \S
message
string
required
Minimum string length: 1
default_computer_id
string
computer_reference_ids
string[]
attachment_ids
string[]

Response

The conversation and its first turn.

conversation
object
required
turn
object
required
status_stream_cursor
integer
required
Required range: x >= 0