Skip to main content
POST
Ask the agent about comments

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.

Path Parameters

id
string
required

The computer's name, such as agent-atlas, or its id (cmp_…). Every caller may use either, the computer's own runtime token included.

Minimum string length: 1
Example:

"agent-atlas"

Body

application/json
comments
object[]
required

Open comments, each at the version you saw, that no running job holds.

Required array length: 1 - 10 elements
to
enum<string>
default:operator

Who does the job: Operator, or the owner's local agent session the board names as listener.

Available options:
operator,
agent
agent
string

With to agent, and only then: the board's listener.agent, the agent the owner was shown. A different agent listening now, or none, is 409 agent_not_listening.

Maximum string length: 64

Response

The job.

Comments the owner asked the agent to handle, done by one operator turn and the turns that continue its work. Asking changes no comment; the agent answers each comment as it acts.

id
string
required
Pattern: ^cjob_[0-9a-f]{24}$
state
enum<string>
required

queued until a turn of its work starts, working until all of its work (the turn and the turns that continue it) ended, then settled.

Available options:
queued,
working,
settled
comments
object[]
required

The comments asked about, at the versions asked.

created_at
string<date-time>
required
outcome
enum<string>

Present once settled: done when the agent answered every comment, partial when some, stopped when none, cancelled when someone stopped one of its turns.

Available options:
done,
partial,
stopped,
cancelled
agent
string

Present for a job sent to the owner's local agent session: the label its watch gave. Kept after Operator took the job over.

Maximum string length: 64
took_over
boolean

Present and true when the local agent session went quiet and Operator took the job over.