Skip to main content
POST
Wait for comments sent to your agent

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
agent
string

Your name as the owner sees it on the site's comments, such as Claude Code; cleaned and cut to 64 bytes. Empty, or a name that could pass for Operator, the owner or Cool Computers (spacing and surrounding punctuation aside), shows as Agent.

Response

A job sent to your session.

A job the owner sent to your session: ids only. Pull it with GET /api/computers/{computer_id}/comments?job_id=, which claims it, naming the computer by computer_id, which a reused slug cannot redirect.

job
string
required
Pattern: ^cjob_[0-9a-f]{24}$
computer_id
string
required
Pattern: ^cmp_[0-9a-f]{24}$
slug
string
required
comments
string[]
required

The ids of the job's comments.