Skip to main content
POST
Resolve computer comment

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"

commentID
string
required

Comment identifier returned by the comment board or the pull.

Minimum string length: 1
Example:

"comment_1a2b3c"

Body

application/json
version
integer
required
Required range: x >= 1
state
enum<string>
required
Available options:
done,
asked
reply
string
required

What you changed, or your question, 1 to maxLength bytes.

Required string length: 1 - 1000
files
string[]

The paths of the files you changed, one line each, shown on your answer: with state done only (a question changes nothing, invalid_comment otherwise), and the same list again on a retry. Optional; list them on a computer with a VM, whose files no release records.

Maximum array length: 30
Required string length: 1 - 300

Response

The resolved comment.

id
string
required
Example:

"comment_1a2b3c"

state
enum<string>
required

open waits for an agent to answer it, asked waits for the owner's answer, done is finished.

Available options:
open,
asked,
done
version
integer
required

Changes on every update; send the one you read when resolving.

Required range: x >= 1
release
integer
required

Release the computer served when the comment was left; 0 when it served none.

anchor
object
required

Where on the page a comment points. An element anchor names its element by selector, and may leave out rect: the page finds the element. An area anchor needs rect unless it carries ink; with ink its selector is the first mark's el, and it may leave out rect too, since the page finds each mark's element. The page shows an anchor's pin by its drawn marks, then by the element its selector finds exactly once, then by its stored rect; with none of them it shows no pin.

thread
object[]
required
fixed_in_release
integer

Release that fixed the comment, when a newer one was published.