Get the comment board
curl --request GET \
--url https://api.cool.computer/api/computers/{id}/comments/all \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.cool.computer/api/computers/{id}/comments/all"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.cool.computer/api/computers/{id}/comments/all', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.cool.computer/api/computers/{id}/comments/all",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.cool.computer/api/computers/{id}/comments/all"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.cool.computer/api/computers/{id}/comments/all")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.cool.computer/api/computers/{id}/comments/all")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"revision": "<string>",
"changed": true,
"enabled": true,
"people": {},
"computer_id": "<string>",
"comments": [
{
"id": "comment_1a2b3c",
"state": "open",
"version": 2,
"release": 123,
"anchor": {
"kind": "element",
"page": "/menu",
"selector": "section > a.cta",
"text": "<string>",
"label": "<string>",
"ink": {
"marks": [
{
"el": "<string>",
"path": "M0 1080 L1000 1080",
"shape": "ring",
"write": "too high?",
"color": "amber",
"on": [
{
"el": "<string>",
"ink": 50,
"text": "<string>"
}
],
"start": "<string>",
"end": "<string>",
"line": "through"
}
]
},
"picture": {
"sha256": "<string>"
},
"rect": {
"x": 50,
"y": 50,
"w": 50,
"h": 50
},
"scroll_y": 5000000
},
"thread": [
{
"by": "owner",
"text": "<string>",
"at": "2023-11-07T05:31:56Z",
"who": "<string>",
"agent": "<string>",
"resolved": "done",
"files": [
"<string>"
],
"request": "<string>"
}
],
"created_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z",
"fixed_in_release": 123
}
],
"jobs": [
{
"id": "<string>",
"state": "queued",
"comments": [
{
"id": "<string>",
"version": 2
}
],
"created_at": "2023-11-07T05:31:56Z",
"outcome": "done",
"agent": "<string>",
"took_over": true
}
],
"listener": {
"agent": "<string>"
},
"you": "<string>",
"owner": "<string>"
}{
"type": "<string>",
"title": "<string>",
"status": 499,
"code": "<string>",
"detail": "<string>",
"resolution": "<string>",
"context": {},
"suggestions": [
"<string>"
]
}{
"type": "<string>",
"title": "<string>",
"status": 499,
"code": "<string>",
"detail": "<string>",
"resolution": "<string>",
"context": {},
"suggestions": [
"<string>"
]
}{
"type": "<string>",
"title": "<string>",
"status": 499,
"code": "<string>",
"detail": "<string>",
"resolution": "<string>",
"context": {},
"suggestions": [
"<string>"
]
}{
"type": "<string>",
"title": "<string>",
"status": 499,
"code": "<string>",
"detail": "<string>",
"resolution": "<string>",
"context": {},
"suggestions": [
"<string>"
]
}{
"type": "<string>",
"title": "<string>",
"status": 499,
"code": "<string>",
"detail": "<string>",
"resolution": "<string>",
"context": {},
"suggestions": [
"<string>"
]
}Comments
Get the comment board
Also accepts this computer's own runtime token, with the computer named by its name or id; a different computer returns 404. Sharing is checked per request using the integration-withholding definition (active shares and pending shares still valid or being accepted). Unshared: owner comment rights. Shared: board, create, reply and versioned retraction of this computer agent's own unanswered comments only; pull, resolve, reopen and deleting others' comments return 403 with advice to ask the owner. Runtime responses carry full threads projected as AgentComment, without member IDs, emails, people maps, you or owner identity; roles identify owner/participant/agent. Runtime writes appear as Agent; shared writes store an opaque computer author id for retraction and per-person thread limits, omitted from runtime responses. The owner, anyone the computer is shared with and, when the computer is public, any signed-in person (a person's own sign-in, not an organization API key), and anyone signed out: a request with no credential at all (no Authorization header and no session cookie) reads a public computer's board as a signed-out visitor, without you, jobs or listener, and with each person named by their profile name or Someone, never an email or part of one; a private computer answers it 404. Send since, the revision you hold. When nothing changed since, the answer is {revision, changed:false, enabled, people, you, owner} without comments; otherwise comments holds every open and asked comment and the 50 comments finished last, with full threads. Human messages carry who as member:<id>, resolved to a name in people; agent messages carry by:agent and agent (their name). The people map holds only you, the owner and the people who wrote on the board; people carry an email only on the owner's board. Reading a board records nothing about who read it. A computer with comments switched off answers enabled:false and no comments. A request with no Authorization header, signed in or signed out, spends its own allowance of 300 board reads a minute per IPv4 address or IPv6 /64, separate from the ordinary source and account allowances; the layer reads the board when a page is shown, so do not poll it faster than that. A session cookie that no longer signs anyone in is answered 401 and cleared, so the next read is a signed-out one. A site published without an account and not yet claimed reads as enabled: false, to everyone, until it is claimed; its stored switch is unchanged.
GET
/
api
/
computers
/
{id}
/
comments
/
all
Get the comment board
curl --request GET \
--url https://api.cool.computer/api/computers/{id}/comments/all \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.cool.computer/api/computers/{id}/comments/all"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.cool.computer/api/computers/{id}/comments/all', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.cool.computer/api/computers/{id}/comments/all",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.cool.computer/api/computers/{id}/comments/all"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.cool.computer/api/computers/{id}/comments/all")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.cool.computer/api/computers/{id}/comments/all")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"revision": "<string>",
"changed": true,
"enabled": true,
"people": {},
"computer_id": "<string>",
"comments": [
{
"id": "comment_1a2b3c",
"state": "open",
"version": 2,
"release": 123,
"anchor": {
"kind": "element",
"page": "/menu",
"selector": "section > a.cta",
"text": "<string>",
"label": "<string>",
"ink": {
"marks": [
{
"el": "<string>",
"path": "M0 1080 L1000 1080",
"shape": "ring",
"write": "too high?",
"color": "amber",
"on": [
{
"el": "<string>",
"ink": 50,
"text": "<string>"
}
],
"start": "<string>",
"end": "<string>",
"line": "through"
}
]
},
"picture": {
"sha256": "<string>"
},
"rect": {
"x": 50,
"y": 50,
"w": 50,
"h": 50
},
"scroll_y": 5000000
},
"thread": [
{
"by": "owner",
"text": "<string>",
"at": "2023-11-07T05:31:56Z",
"who": "<string>",
"agent": "<string>",
"resolved": "done",
"files": [
"<string>"
],
"request": "<string>"
}
],
"created_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z",
"fixed_in_release": 123
}
],
"jobs": [
{
"id": "<string>",
"state": "queued",
"comments": [
{
"id": "<string>",
"version": 2
}
],
"created_at": "2023-11-07T05:31:56Z",
"outcome": "done",
"agent": "<string>",
"took_over": true
}
],
"listener": {
"agent": "<string>"
},
"you": "<string>",
"owner": "<string>"
}{
"type": "<string>",
"title": "<string>",
"status": 499,
"code": "<string>",
"detail": "<string>",
"resolution": "<string>",
"context": {},
"suggestions": [
"<string>"
]
}{
"type": "<string>",
"title": "<string>",
"status": 499,
"code": "<string>",
"detail": "<string>",
"resolution": "<string>",
"context": {},
"suggestions": [
"<string>"
]
}{
"type": "<string>",
"title": "<string>",
"status": 499,
"code": "<string>",
"detail": "<string>",
"resolution": "<string>",
"context": {},
"suggestions": [
"<string>"
]
}{
"type": "<string>",
"title": "<string>",
"status": 499,
"code": "<string>",
"detail": "<string>",
"resolution": "<string>",
"context": {},
"suggestions": [
"<string>"
]
}{
"type": "<string>",
"title": "<string>",
"status": 499,
"code": "<string>",
"detail": "<string>",
"resolution": "<string>",
"context": {},
"suggestions": [
"<string>"
]
}Authorizations
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
Response
The board.
- Option 1
- Option 2

