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). Leaves a comment on a page of the computer’s site, anchored to an element or an area. Text is cleaned and must be 1 byte up to the text’s maxLength in CreateCommentRequest, and may be empty for a drawing. The owner’s agents read it with the pull; the owner hands it to Operator with POST /api/computers//comments/ask. An agent with the owner’s credential leaves a comment the same way (the MCP tool cool_leave_comment), naming itself in agent so the comment is the agent’s, not the owner’s: an element anchor with only page and selector, rect left out, or a drawing: an area anchor with page and ink.marks, each mark an element’s el and one of a path in that element’s own box, a named shape or words to write (see CommentInk), selector and rect left out, or a part of the page: an area anchor with page and rect (the tool’s area), selector and ink left out. A computer holds any number of comments. Anyone but the owner and the people the computer is shared with may make 10 writes a minute on one computer, and together 60 new comments an hour.
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
text
string
required
What should change, at most maxLength bytes. May be empty when the anchor carries ink: a drawing says what to change without words.
Maximum string length: 1000
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.
Show child attributes
request
string
An id the client gives this create, new for each comment, and sends again with the same create when the answer was lost: a comment you already left with that request, the same text and the same anchor is the answer (201) and nothing is stored, and other text or another anchor under it is 400 invalid_comment: send new words with a new request. The server always chooses the comment's id. Leave it out to always leave a new comment.
Pattern: ^[0-9a-f]{24}$
picture
string
Only with an anchor that carries ink: what the person saw where they drew, a PNG of at most 1500000 bytes and 2000 pixels a side. The server keeps it as sent, so the client blanks what must not be shown (password fields) before sending it, and sets the anchor's picture; an anchor's own picture is ignored.
agent
string
Your name, such as Codex, when you are an agent leaving this comment with the owner's own credential (cool comments leave sends it): the comment is then that agent's, not the owner's, and its name is shown on the comment and the page's pen. Left out or empty, the comment is the credential's own, as without it. Cleaned and cut to maxLength bytes; a name that cleans to nothing, or could pass for Operator, the owner or Cool Computers (spacing and surrounding punctuation aside), shows as Agent. Ignored for anyone else, the computer's own runtime token included: their comment is theirs.
Maximum string length: 64
Response
The new comment.
Option 1
Option 2
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.
Show child attributes
thread
object[]
required
Show child attributes
created_at
string<date-time>
required
updated_at
string<date-time>
required
fixed_in_release
integer
Release that fixed the comment, when a newer one was published.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Cool Computers","description":"The official Cool Computers user and developer guide: connect your agent, the CLI, the HTTP API, authentication, and computers.","colors":{"primary":"#155DFF","light":"#6AA0FF","dark":"#1D69FF"},"logo":{"light":"https://mintcdn.com/cool-computer/gsKImuLFY1EhcYOS/logo-light.png?fit=max\u0026auto=format\u0026n=gsKImuLFY1EhcYOS\u0026q=85\u0026s=7ce85c74fc810b3de8ef57e45d050e55","dark":"https://mintcdn.com/cool-computer/gsKImuLFY1EhcYOS/logo-dark.png?fit=max\u0026auto=format\u0026n=gsKImuLFY1EhcYOS\u0026q=85\u0026s=9b597646bef5e7b77a9ce87dce31343b"},"favicon":"https://mintcdn.com/cool-computer/gsKImuLFY1EhcYOS/favicon.png?fit=max\u0026auto=format\u0026n=gsKImuLFY1EhcYOS\u0026q=85\u0026s=52fe991b99c59c1821981b86f6d67fcb","appearance":{"default":"system"},"background":{"color":{"light":"#F3F4F6","dark":"#0E0F11"}},"navbar":{"links":[{"href":"https://www.cool.computer/contact","label":"Support"}],"primary":{"type":"button","label":"Open dashboard","href":"https://www.cool.computer/app"}},"icons":{"library":"lucide"},"contextual":{"options":["copy","view","chatgpt","claude","perplexity"],"display":"header"},"styling":{"latex":false},"navigation":{"global":{"anchors":[{"anchor":"Cool Computers","icon":"globe","color":{"light":"#155DFF","dark":"#6AA0FF"},"href":"https://www.cool.computer"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"cool-computer","hasAudioNarration":false,"actualSubdomain":"cool-computer","customDomains":["cool.computer"],"gitSource":{"type":"github","owner":"the-money-company-limited","repo":"coolcomputerdocs","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"","label":""},"entitlements":{"AI_CHAT":{"status":"DISABLED"}},"buildId":"6af619272d34b58e26d60fb1","clientVersion":"0.0.4270","searchFilterCounts":[{"language":"default","tag":"Endpoint reference","count":138},{"language":"default","tag":"Connect your agent","count":14},{"language":"default","tag":"Authentication","count":14},{"language":"default","tag":"Operator","count":14},{"language":"default","tag":"Comments","count":13},{"language":"default","tag":"Publishing","count":13},{"language":"default","tag":"Files","count":10},{"language":"default","tag":"Integrations","count":9},{"language":"default","tag":"Services","count":9},{"language":"default","tag":"Secrets","count":8}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"/docs","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"site-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"starter-pricing","enabled":true,"variant":{"name":"control","enabled":true,"payload":{"type":"string","value":"control"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"wildcard-email-auth","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[]}
{"page":{"pagePath":"api-reference/comments/create-computer-comment","slug":"/api-reference/comments/create-computer-comment","pageMetadata":{"title":"Create computer comment","description":"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). Leaves a comment on a page of the computer's site, anchored to an element or an area. Text is cleaned and must be 1 byte up to the text's maxLength in CreateCommentRequest, and may be empty for a drawing. The owner's agents read it with the pull; the owner hands it to Operator with POST /api/computers/{id}/comments/ask. An agent with the owner's credential leaves a comment the same way (the MCP tool cool_leave_comment), naming itself in agent so the comment is the agent's, not the owner's: an element anchor with only page and selector, rect left out, or a drawing: an area anchor with page and ink.marks, each mark an element's el and one of a path in that element's own box, a named shape or words to write (see CommentInk), selector and rect left out, or a part of the page: an area anchor with page and rect (the tool's area), selector and ink left out. A computer holds any number of comments. Anyone but the owner and the people the computer is shared with may make 10 writes a minute on one computer, and together 60 new comments an hour.","deprecated":null,"version":null,"openapi":"https://www.cool.computer/openapi.json post /api/computers/{id}/comments","href":"/api-reference/comments/create-computer-comment","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_components.p, {\n children: [\"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). Leaves a comment on a page of the computer’s site, anchored to an element or an area. Text is cleaned and must be 1 byte up to the text’s maxLength in CreateCommentRequest, and may be empty for a drawing. The owner’s agents read it with the pull; the owner hands it to Operator with POST /api/computers/\", \"/comments/ask. An agent with the owner’s credential leaves a comment the same way (the MCP tool cool_leave_comment), naming itself in agent so the comment is the agent’s, not the owner’s: an element anchor with only page and selector, rect left out, or a drawing: an area anchor with page and ink.marks, each mark an element’s el and one of a path in that element’s own box, a named shape or words to write (see CommentInk), selector and rect left out, or a part of the page: an area anchor with page and rect (the tool’s area), selector and ink left out. A computer holds any number of comments. Anyone but the owner and the people the computer is shared with may make 10 writes a minute on one computer, and together 60 new comments an hour.\"]\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Create computer comment","description":"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). Leaves a comment on a page of the computer's site, anchored to an element or an area. Text is cleaned and must be 1 byte up to the text's maxLength in CreateCommentRequest, and may be empty for a drawing. The owner's agents read it with the pull; the owner hands it to Operator with POST /api/computers/{id}/comments/ask. An agent with the owner's credential leaves a comment the same way (the MCP tool cool_leave_comment), naming itself in agent so the comment is the agent's, not the owner's: an element anchor with only page and selector, rect left out, or a drawing: an area anchor with page and ink.marks, each mark an element's el and one of a path in that element's own box, a named shape or words to write (see CommentInk), selector and rect left out, or a part of the page: an area anchor with page and rect (the tool's area), selector and ink left out. A computer holds any number of comments. Anyone but the owner and the people the computer is shared with may make 10 writes a minute on one computer, and together 60 new comments an hour.","deprecated":null,"version":null,"openapi":"https://www.cool.computer/openapi.json post /api/computers/{id}/comments","href":"/api-reference/comments/create-computer-comment","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"operationId":"createComputerComment","summary":"Create computer comment","description":"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). Leaves a comment on a page of the computer's site, anchored to an element or an area. Text is cleaned and must be 1 byte up to the text's maxLength in CreateCommentRequest, and may be empty for a drawing. The owner's agents read it with the pull; the owner hands it to Operator with POST /api/computers/{id}/comments/ask. An agent with the owner's credential leaves a comment the same way (the MCP tool cool_leave_comment), naming itself in agent so the comment is the agent's, not the owner's: an element anchor with only page and selector, rect left out, or a drawing: an area anchor with page and ink.marks, each mark an element's el and one of a path in that element's own box, a named shape or words to write (see CommentInk), selector and rect left out, or a part of the page: an area anchor with page and rect (the tool's area), selector and ink left out. A computer holds any number of comments. Anyone but the owner and the people the computer is shared with may make 10 writes a minute on one computer, and together 60 new comments an hour.","tags":["Comments"],"security":["15db37d7-9534-454c-9ee9-175b03f095b9"],"parameters":["aec743c0-9e35-43b4-9ed2-9aa2e0f8376d"],"requestBody":"5b03b583-7f67-44d9-bd99-872c31cc08af","responses":{"201":"2c0bbb04-de1a-4587-b2c2-1df678613cdf","400":"c6bcc14a-7d03-4a2e-ae67-9f1f1674aa6a","401":"77448393-28c3-4c76-929e-a6c68a3bf70f","404":"965525ea-b79a-4fce-94e0-dfbcc565ef85","413":"79801249-74bc-444b-b49e-a4fbb393e615","429":"eab5bd72-4236-4ac1-aff1-2aea2e23d426","500":"4aec46df-cba8-4b9a-ba48-c3f7bf127b87","default":"52a14487-ec0f-4d66-93a5-865e7da3567a"},"method":"post","type":"path","servers":["87260cfd-6eb9-4cfd-9719-f9d5b3e89d18"],"path":"/api/computers/{id}/comments","baseUrlOptions":["https://api.cool.computer"],"title":"Create computer comment","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"aec743c0-9e35-43b4-9ed2-9aa2e0f8376d":{"name":"id","in":"path","required":true,"description":"The computer's name, such as agent-atlas, or its id (cmp_…). Every caller may use either, the computer's own runtime token included.","schema":{"type":"string","minLength":1,"example":"agent-atlas","isRequired":true,"description":"The computer's name, such as agent-atlas, or its id (cmp_…). Every caller may use either, the computer's own runtime token included.","uniqueKey":"","typeLabel":"string"}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["text","anchor"],"properties":{"text":{"type":"string","maxLength":1000,"description":"What should change, at most maxLength bytes. May be empty when the anchor carries ink: a drawing says what to change without words.","isRequired":true,"uniqueKey":"text","typeLabel":"string"},"anchor":{"type":"object","additionalProperties":false,"required":["kind","page"],"description":"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.","properties":{"kind":{"type":"string","enum":["element","area"],"isRequired":true,"uniqueKey":"anchor.kind","typeLabel":"enum\u003cstring>"},"page":{"type":"string","maxLength":500,"description":"Path of the page, starting with /. The server stores it as the page's key, by the page rules of the comments contract that the page's comment script applies too: it is percent-encoded as a browser's location writes it (non-ASCII as UTF-8, hex in upper case, no escape decoded, so /café is stored as /caf%C3%A9), query parameters whose names hold a credential name are removed, path segments that look like tokens (a compact JWT, or a long run of URL-safe characters with a digit) become :token, a hash is kept only when it is a #/ or #! route (keyed the same way), and a key over maxLength keeps its path alone, without its query or hash. So /preview/\u003ctoken>?token=x\u0026lang=en is stored as /preview/:token?lang=en.","example":"/menu","isRequired":true,"uniqueKey":"anchor.page","typeLabel":"string"},"selector":{"type":"string","maxLength":300,"description":"Selector the comment script made: steps of a tag, #id or [id=\"x\"], up to two .classes, [data-testid=\"x\"] and :nth-of-type(n), joined by \" > \", at most 12 steps and maxLength bytes. Required for an element. For an area with ink it is the first mark's el, filled in when left out.","example":"section > a.cta","uniqueKey":"anchor.selector","typeLabel":"string"},"text":{"type":"string","description":"Text near the anchor; the server cuts it to 200 bytes.","uniqueKey":"anchor.text","typeLabel":"string"},"label":{"type":"string","description":"Accessible label of the element; the server cuts it to 120 bytes.","uniqueKey":"anchor.label","typeLabel":"string"},"ink":{"type":"object","additionalProperties":false,"required":["marks"],"description":"A drawing on the page, only on an area anchor: marks, each on one element and drawn relative to it, so a drawing lands in the same place on every screen. A mark is exactly one of path (strokes in the element's own box), shape (a named shape the page draws by hand) or write (words the page writes beside the element), with an optional color. A person's browser sends only paths, which also carry what it measured (on, start, end, line). At most 64000 bytes as JSON.","properties":{"marks":{"type":"array","minItems":1,"maxItems":20,"items":{"oneOf":[{"type":"object","required":["el","path"],"properties":{"el":{"type":"string","minLength":1,"maxLength":300,"description":"Selector of the one element the mark is drawn on, in the same shape as an anchor's; html means the whole page (its full scroll size, so one unit is a thousandth of the page). A mark whose element the page does not find exactly once, or that is hidden or clipped away, is not drawn.","isRequired":true,"uniqueKey":"anchor.ink.marks.items.[INDEX].oneOf.0.el","typeLabel":"string"},"path":{"type":"string","maxLength":4000,"pattern":"^M-?\\d+ -?\\d+(?: [ML]-?\\d+ -?\\d+)*$","description":"The strokes in whole thousandths of el's border box: 0 is its left or top edge and 1000 its right or bottom, on each axis on its own, and a number below 0 or past 1000 is outside it, from -100000 to 100000. A move, then lines, a move for each stroke after the first. An underline: M0 1080 L1000 1080.","example":"M0 1080 L1000 1080","isRequired":true,"uniqueKey":"anchor.ink.marks.items.[INDEX].oneOf.0.path","typeLabel":"string"},"shape":{"type":"string","enum":["ring","box","underline","strike","cross"],"description":"A shape the page draws by hand to fit el's own text, in place of path and write: ring or box around it, underline, strike through it, cross over it. It is stored and read back by its name.","uniqueKey":"anchor.ink.marks.items.[INDEX].oneOf.0.shape","typeLabel":"enum\u003cstring>"},"write":{"type":"string","minLength":1,"maxLength":160,"description":"Words the page writes by hand beside el, in place of path and shape: at most 160 UTF-8 bytes on at most 3 lines split by \\n, cleaned like a comment's text, in printable ASCII and £ € ← ↑ → ↓ ✓ ✗; a character the hand cannot write is refused.","example":"too high?","uniqueKey":"anchor.ink.marks.items.[INDEX].oneOf.0.write","typeLabel":"string"},"color":{"type":"string","enum":["amber","blue","green","ink","purple","red"],"description":"The mark's colour; amber when left out, and then read back without one.","uniqueKey":"anchor.ink.marks.items.[INDEX].oneOf.0.color","typeLabel":"enum\u003cstring>"},"on":{"type":"array","maxItems":3,"description":"Measured by a person's browser: elements under the mark, the most covered first.","items":{"type":"object","additionalProperties":false,"required":["el","ink"],"properties":{"el":{"type":"string","maxLength":300,"description":"Selector, in the same shape as an anchor's.","isRequired":true,"uniqueKey":"anchor.ink.marks.items.[INDEX].oneOf.0.on.items.[INDEX].el","typeLabel":"string"},"ink":{"type":"integer","minimum":1,"maximum":100,"description":"Percent of the mark's samples on the element.","isRequired":true,"uniqueKey":"anchor.ink.marks.items.[INDEX].oneOf.0.on.items.[INDEX].ink","typeLabel":"integer"},"text":{"type":"string","description":"The element's text; the server cuts it to 60 bytes.","uniqueKey":"anchor.ink.marks.items.[INDEX].oneOf.0.on.items.[INDEX].text","typeLabel":"string"}},"uniqueKey":"anchor.ink.marks.items.[INDEX].oneOf.0.on.items.[INDEX]","typeLabel":"object"},"uniqueKey":"anchor.ink.marks.items.[INDEX].oneOf.0.on","typeLabel":"object[]"},"start":{"type":"string","maxLength":300,"description":"Measured by a person's browser: selector of the element under a line's first point.","uniqueKey":"anchor.ink.marks.items.[INDEX].oneOf.0.start","typeLabel":"string"},"end":{"type":"string","maxLength":300,"description":"Measured by a person's browser: selector of the element under a line's last point.","uniqueKey":"anchor.ink.marks.items.[INDEX].oneOf.0.end","typeLabel":"string"},"line":{"type":"string","enum":["through","under","around"],"description":"Measured by a person's browser: whether the mark runs through or under text, or around something.","uniqueKey":"anchor.ink.marks.items.[INDEX].oneOf.0.line","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"uniqueKey":"anchor.ink.marks.items.[INDEX].oneOf.0","typeLabel":"object"},{"type":"object","required":["el","shape"],"properties":{"el":{"type":"string","minLength":1,"maxLength":300,"description":"Selector of the one element the mark is drawn on, in the same shape as an anchor's; html means the whole page (its full scroll size, so one unit is a thousandth of the page). A mark whose element the page does not find exactly once, or that is hidden or clipped away, is not drawn.","isRequired":true,"uniqueKey":"anchor.ink.marks.items.[INDEX].oneOf.1.el","typeLabel":"string"},"shape":{"type":"string","enum":["ring","box","underline","strike","cross"],"description":"A shape the page draws by hand to fit el's own text, in place of path and write: ring or box around it, underline, strike through it, cross over it. It is stored and read back by its name.","isRequired":true,"uniqueKey":"anchor.ink.marks.items.[INDEX].oneOf.1.shape","typeLabel":"enum\u003cstring>"},"write":{"type":"string","minLength":1,"maxLength":160,"description":"Words the page writes by hand beside el, in place of path and shape: at most 160 UTF-8 bytes on at most 3 lines split by \\n, cleaned like a comment's text, in printable ASCII and £ € ← ↑ → ↓ ✓ ✗; a character the hand cannot write is refused.","example":"too high?","uniqueKey":"anchor.ink.marks.items.[INDEX].oneOf.1.write","typeLabel":"string"},"color":{"type":"string","enum":["amber","blue","green","ink","purple","red"],"description":"The mark's colour; amber when left out, and then read back without one.","uniqueKey":"anchor.ink.marks.items.[INDEX].oneOf.1.color","typeLabel":"enum\u003cstring>"},"path":{"type":"string","maxLength":4000,"pattern":"^M-?\\d+ -?\\d+(?: [ML]-?\\d+ -?\\d+)*$","description":"The strokes in whole thousandths of el's border box: 0 is its left or top edge and 1000 its right or bottom, on each axis on its own, and a number below 0 or past 1000 is outside it, from -100000 to 100000. A move, then lines, a move for each stroke after the first. An underline: M0 1080 L1000 1080.","example":"M0 1080 L1000 1080","uniqueKey":"anchor.ink.marks.items.[INDEX].oneOf.1.path","typeLabel":"string"},"on":{"type":"array","maxItems":3,"description":"Measured by a person's browser: elements under the mark, the most covered first.","items":{"type":"object","additionalProperties":false,"required":["el","ink"],"properties":{"el":{"type":"string","maxLength":300,"description":"Selector, in the same shape as an anchor's.","isRequired":true,"uniqueKey":"anchor.ink.marks.items.[INDEX].oneOf.1.on.items.[INDEX].el","typeLabel":"string"},"ink":{"type":"integer","minimum":1,"maximum":100,"description":"Percent of the mark's samples on the element.","isRequired":true,"uniqueKey":"anchor.ink.marks.items.[INDEX].oneOf.1.on.items.[INDEX].ink","typeLabel":"integer"},"text":{"type":"string","description":"The element's text; the server cuts it to 60 bytes.","uniqueKey":"anchor.ink.marks.items.[INDEX].oneOf.1.on.items.[INDEX].text","typeLabel":"string"}},"uniqueKey":"anchor.ink.marks.items.[INDEX].oneOf.1.on.items.[INDEX]","typeLabel":"object"},"uniqueKey":"anchor.ink.marks.items.[INDEX].oneOf.1.on","typeLabel":"object[]"},"start":{"type":"string","maxLength":300,"description":"Measured by a person's browser: selector of the element under a line's first point.","uniqueKey":"anchor.ink.marks.items.[INDEX].oneOf.1.start","typeLabel":"string"},"end":{"type":"string","maxLength":300,"description":"Measured by a person's browser: selector of the element under a line's last point.","uniqueKey":"anchor.ink.marks.items.[INDEX].oneOf.1.end","typeLabel":"string"},"line":{"type":"string","enum":["through","under","around"],"description":"Measured by a person's browser: whether the mark runs through or under text, or around something.","uniqueKey":"anchor.ink.marks.items.[INDEX].oneOf.1.line","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"uniqueKey":"anchor.ink.marks.items.[INDEX].oneOf.1","typeLabel":"object"},{"type":"object","required":["el","write"],"properties":{"el":{"type":"string","minLength":1,"maxLength":300,"description":"Selector of the one element the mark is drawn on, in the same shape as an anchor's; html means the whole page (its full scroll size, so one unit is a thousandth of the page). A mark whose element the page does not find exactly once, or that is hidden or clipped away, is not drawn.","isRequired":true,"uniqueKey":"anchor.ink.marks.items.[INDEX].oneOf.2.el","typeLabel":"string"},"write":{"type":"string","minLength":1,"maxLength":160,"description":"Words the page writes by hand beside el, in place of path and shape: at most 160 UTF-8 bytes on at most 3 lines split by \\n, cleaned like a comment's text, in printable ASCII and £ € ← ↑ → ↓ ✓ ✗; a character the hand cannot write is refused.","example":"too high?","isRequired":true,"uniqueKey":"anchor.ink.marks.items.[INDEX].oneOf.2.write","typeLabel":"string"},"shape":{"type":"string","enum":["ring","box","underline","strike","cross"],"description":"A shape the page draws by hand to fit el's own text, in place of path and write: ring or box around it, underline, strike through it, cross over it. It is stored and read back by its name.","uniqueKey":"anchor.ink.marks.items.[INDEX].oneOf.2.shape","typeLabel":"enum\u003cstring>"},"color":{"type":"string","enum":["amber","blue","green","ink","purple","red"],"description":"The mark's colour; amber when left out, and then read back without one.","uniqueKey":"anchor.ink.marks.items.[INDEX].oneOf.2.color","typeLabel":"enum\u003cstring>"},"path":{"type":"string","maxLength":4000,"pattern":"^M-?\\d+ -?\\d+(?: [ML]-?\\d+ -?\\d+)*$","description":"The strokes in whole thousandths of el's border box: 0 is its left or top edge and 1000 its right or bottom, on each axis on its own, and a number below 0 or past 1000 is outside it, from -100000 to 100000. A move, then lines, a move for each stroke after the first. An underline: M0 1080 L1000 1080.","example":"M0 1080 L1000 1080","uniqueKey":"anchor.ink.marks.items.[INDEX].oneOf.2.path","typeLabel":"string"},"on":{"type":"array","maxItems":3,"description":"Measured by a person's browser: elements under the mark, the most covered first.","items":{"type":"object","additionalProperties":false,"required":["el","ink"],"properties":{"el":{"type":"string","maxLength":300,"description":"Selector, in the same shape as an anchor's.","isRequired":true,"uniqueKey":"anchor.ink.marks.items.[INDEX].oneOf.2.on.items.[INDEX].el","typeLabel":"string"},"ink":{"type":"integer","minimum":1,"maximum":100,"description":"Percent of the mark's samples on the element.","isRequired":true,"uniqueKey":"anchor.ink.marks.items.[INDEX].oneOf.2.on.items.[INDEX].ink","typeLabel":"integer"},"text":{"type":"string","description":"The element's text; the server cuts it to 60 bytes.","uniqueKey":"anchor.ink.marks.items.[INDEX].oneOf.2.on.items.[INDEX].text","typeLabel":"string"}},"uniqueKey":"anchor.ink.marks.items.[INDEX].oneOf.2.on.items.[INDEX]","typeLabel":"object"},"uniqueKey":"anchor.ink.marks.items.[INDEX].oneOf.2.on","typeLabel":"object[]"},"start":{"type":"string","maxLength":300,"description":"Measured by a person's browser: selector of the element under a line's first point.","uniqueKey":"anchor.ink.marks.items.[INDEX].oneOf.2.start","typeLabel":"string"},"end":{"type":"string","maxLength":300,"description":"Measured by a person's browser: selector of the element under a line's last point.","uniqueKey":"anchor.ink.marks.items.[INDEX].oneOf.2.end","typeLabel":"string"},"line":{"type":"string","enum":["through","under","around"],"description":"Measured by a person's browser: whether the mark runs through or under text, or around something.","uniqueKey":"anchor.ink.marks.items.[INDEX].oneOf.2.line","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"uniqueKey":"anchor.ink.marks.items.[INDEX].oneOf.2","typeLabel":"object"}],"uniqueKey":"anchor.ink.marks.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"anchor.ink.marks","typeLabel":"object[]"}},"uniqueKey":"anchor.ink","typeLabel":"object"},"picture":{"type":"object","additionalProperties":false,"required":["sha256"],"description":"Set by the server, never sent in an anchor: a drawing has a picture of what the person saw where they drew, a PNG of the page around their ink with the ink on it, as the client that sent it drew it. The server keeps the bytes as sent. The pull returns it under pictures with ?pictures=1.","properties":{"sha256":{"type":"string","pattern":"^[0-9a-f]{64}$","description":"Hex SHA-256 of the PNG.","isRequired":true,"uniqueKey":"anchor.picture.sha256","typeLabel":"string"}},"uniqueKey":"anchor.picture","typeLabel":"object"},"rect":{"type":"object","additionalProperties":false,"required":["x","y","w","h"],"description":"A box in percent of the page, inside it.","properties":{"x":{"type":"number","minimum":0,"maximum":100,"isRequired":true,"uniqueKey":"anchor.rect.x","typeLabel":"number"},"y":{"type":"number","minimum":0,"maximum":100,"isRequired":true,"uniqueKey":"anchor.rect.y","typeLabel":"number"},"w":{"type":"number","minimum":0,"maximum":100,"isRequired":true,"uniqueKey":"anchor.rect.w","typeLabel":"number"},"h":{"type":"number","minimum":0,"maximum":100,"isRequired":true,"uniqueKey":"anchor.rect.h","typeLabel":"number"}},"conditionalRequirements":[{}],"uniqueKey":"anchor.rect","typeLabel":"object"},"scroll_y":{"type":"number","minimum":0,"maximum":10000000,"description":"Scroll offset of the page in pixels when the comment was left.","uniqueKey":"anchor.scroll_y","typeLabel":"number"}},"conditionallyRequiredProperties":{"rect":[{}]},"isRequired":true,"uniqueKey":"anchor","typeLabel":"object"},"request":{"type":"string","pattern":"^[0-9a-f]{24}$","description":"An id the client gives this create, new for each comment, and sends again with the same create when the answer was lost: a comment you already left with that request, the same text and the same anchor is the answer (201) and nothing is stored, and other text or another anchor under it is 400 invalid_comment: send new words with a new request. The server always chooses the comment's id. Leave it out to always leave a new comment.","uniqueKey":"request","typeLabel":"string"},"picture":{"type":"string","contentEncoding":"base64","description":"Only with an anchor that carries ink: what the person saw where they drew, a PNG of at most 1500000 bytes and 2000 pixels a side. The server keeps it as sent, so the client blanks what must not be shown (password fields) before sending it, and sets the anchor's picture; an anchor's own picture is ignored.","uniqueKey":"picture","typeLabel":"string"},"agent":{"type":"string","maxLength":64,"description":"Your name, such as Codex, when you are an agent leaving this comment with the owner's own credential (cool comments leave sends it): the comment is then that agent's, not the owner's, and its name is shown on the comment and the page's pen. Left out or empty, the comment is the credential's own, as without it. Cleaned and cut to maxLength bytes; a name that cleans to nothing, or could pass for Operator, the owner or Cool Computers (spacing and surrounding punctuation aside), shows as Agent. Ignored for anyone else, the computer's own runtime token included: their comment is theirs.","uniqueKey":"agent","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"text":"\u003cstring>","anchor":{"page":"/menu","selector":"section > a.cta","text":"\u003cstring>","label":"\u003cstring>","scroll_y":5000000},"request":"\u003cstring>","picture":"\u003cstring>","agent":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"2c0bbb04-de1a-4587-b2c2-1df678613cdf":{"headers":{"RateLimit":{"description":"The applied policy name, requests remaining after this request, and whole seconds until the current UTC-aligned window resets.","schema":{"type":"string","pattern":"^\"(account|account-read|computer|computer-read|browser|browser-read|document|source|comment-board|comment-live|comment-write)\";r=[0-9]+;t=([1-9]|[1-5][0-9]|60)$","examples":["\"account\";r=599;t=42","\"computer-read\";r=598;t=42"]}},"RateLimit-Policy":{"description":"The selected policy name, quota, and window in seconds. Valid account credentials use account or account-read with q=600, computer credentials use computer or computer-read with q=600, a browser session uses browser or browser-read with q=600 on the website's same-origin requests and document with q=600 on document routes, unauthenticated or unrecognized requests use source with q=60 for their source IP, a request without an Authorization header reading a comment board uses comment-board with q=300 for its source IP, writing to comments (the comment layer's writes and steps) uses comment-write with q=60 for its source IP, and a browser session's handshake of a comment live channel uses comment-live with q=60 for its source IP.","schema":{"type":"string","pattern":"^(\"(account|account-read|computer|computer-read|browser|browser-read|document)\";q=600|\"(source|comment-live|comment-write)\";q=60|\"comment-board\";q=300);w=60$","examples":["\"account\";q=600;w=60","\"computer-read\";q=600;w=60"]}}},"description":"The new comment.","content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["id","state","version","release","anchor","thread","created_at","updated_at"],"properties":{"id":{"type":"string","example":"comment_1a2b3c","isRequired":true,"uniqueKey":"oneOf.0.id","typeLabel":"string"},"state":{"type":"string","enum":["open","asked","done"],"description":"open waits for an agent to answer it, asked waits for the owner's answer, done is finished.","isRequired":true,"uniqueKey":"oneOf.0.state","typeLabel":"enum\u003cstring>"},"version":{"type":"integer","minimum":1,"description":"Changes on every update; send the one you read when resolving.","isRequired":true,"uniqueKey":"oneOf.0.version","typeLabel":"integer"},"release":{"type":"integer","description":"Release the computer served when the comment was left; 0 when it served none.","isRequired":true,"uniqueKey":"oneOf.0.release","typeLabel":"integer"},"anchor":{"type":"object","additionalProperties":false,"required":["kind","page"],"description":"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.","properties":{"kind":{"type":"string","enum":["element","area"],"isRequired":true,"uniqueKey":"oneOf.0.anchor.kind","typeLabel":"enum\u003cstring>"},"page":{"type":"string","maxLength":500,"description":"Path of the page, starting with /. The server stores it as the page's key, by the page rules of the comments contract that the page's comment script applies too: it is percent-encoded as a browser's location writes it (non-ASCII as UTF-8, hex in upper case, no escape decoded, so /café is stored as /caf%C3%A9), query parameters whose names hold a credential name are removed, path segments that look like tokens (a compact JWT, or a long run of URL-safe characters with a digit) become :token, a hash is kept only when it is a #/ or #! route (keyed the same way), and a key over maxLength keeps its path alone, without its query or hash. So /preview/\u003ctoken>?token=x\u0026lang=en is stored as /preview/:token?lang=en.","example":"/menu","isRequired":true,"uniqueKey":"oneOf.0.anchor.page","typeLabel":"string"},"selector":{"type":"string","maxLength":300,"description":"Selector the comment script made: steps of a tag, #id or [id=\"x\"], up to two .classes, [data-testid=\"x\"] and :nth-of-type(n), joined by \" > \", at most 12 steps and maxLength bytes. Required for an element. For an area with ink it is the first mark's el, filled in when left out.","example":"section > a.cta","uniqueKey":"oneOf.0.anchor.selector","typeLabel":"string"},"text":{"type":"string","description":"Text near the anchor; the server cuts it to 200 bytes.","uniqueKey":"oneOf.0.anchor.text","typeLabel":"string"},"label":{"type":"string","description":"Accessible label of the element; the server cuts it to 120 bytes.","uniqueKey":"oneOf.0.anchor.label","typeLabel":"string"},"ink":{"type":"object","additionalProperties":false,"required":["marks"],"description":"A drawing on the page, only on an area anchor: marks, each on one element and drawn relative to it, so a drawing lands in the same place on every screen. A mark is exactly one of path (strokes in the element's own box), shape (a named shape the page draws by hand) or write (words the page writes beside the element), with an optional color. A person's browser sends only paths, which also carry what it measured (on, start, end, line). At most 64000 bytes as JSON.","properties":{"marks":{"type":"array","minItems":1,"maxItems":20,"items":{"oneOf":[{"type":"object","required":["el","path"],"properties":{"el":{"type":"string","minLength":1,"maxLength":300,"description":"Selector of the one element the mark is drawn on, in the same shape as an anchor's; html means the whole page (its full scroll size, so one unit is a thousandth of the page). A mark whose element the page does not find exactly once, or that is hidden or clipped away, is not drawn.","isRequired":true,"uniqueKey":"oneOf.0.anchor.ink.marks.items.[INDEX].oneOf.0.el","typeLabel":"string"},"path":{"type":"string","maxLength":4000,"pattern":"^M-?\\d+ -?\\d+(?: [ML]-?\\d+ -?\\d+)*$","description":"The strokes in whole thousandths of el's border box: 0 is its left or top edge and 1000 its right or bottom, on each axis on its own, and a number below 0 or past 1000 is outside it, from -100000 to 100000. A move, then lines, a move for each stroke after the first. An underline: M0 1080 L1000 1080.","example":"M0 1080 L1000 1080","isRequired":true,"uniqueKey":"oneOf.0.anchor.ink.marks.items.[INDEX].oneOf.0.path","typeLabel":"string"},"shape":{"type":"string","enum":["ring","box","underline","strike","cross"],"description":"A shape the page draws by hand to fit el's own text, in place of path and write: ring or box around it, underline, strike through it, cross over it. It is stored and read back by its name.","uniqueKey":"oneOf.0.anchor.ink.marks.items.[INDEX].oneOf.0.shape","typeLabel":"enum\u003cstring>"},"write":{"type":"string","minLength":1,"maxLength":160,"description":"Words the page writes by hand beside el, in place of path and shape: at most 160 UTF-8 bytes on at most 3 lines split by \\n, cleaned like a comment's text, in printable ASCII and £ € ← ↑ → ↓ ✓ ✗; a character the hand cannot write is refused.","example":"too high?","uniqueKey":"oneOf.0.anchor.ink.marks.items.[INDEX].oneOf.0.write","typeLabel":"string"},"color":{"type":"string","enum":["amber","blue","green","ink","purple","red"],"description":"The mark's colour; amber when left out, and then read back without one.","uniqueKey":"oneOf.0.anchor.ink.marks.items.[INDEX].oneOf.0.color","typeLabel":"enum\u003cstring>"},"on":{"type":"array","maxItems":3,"description":"Measured by a person's browser: elements under the mark, the most covered first.","items":{"type":"object","additionalProperties":false,"required":["el","ink"],"properties":{"el":{"type":"string","maxLength":300,"description":"Selector, in the same shape as an anchor's.","isRequired":true,"uniqueKey":"oneOf.0.anchor.ink.marks.items.[INDEX].oneOf.0.on.items.[INDEX].el","typeLabel":"string"},"ink":{"type":"integer","minimum":1,"maximum":100,"description":"Percent of the mark's samples on the element.","isRequired":true,"uniqueKey":"oneOf.0.anchor.ink.marks.items.[INDEX].oneOf.0.on.items.[INDEX].ink","typeLabel":"integer"},"text":{"type":"string","description":"The element's text; the server cuts it to 60 bytes.","uniqueKey":"oneOf.0.anchor.ink.marks.items.[INDEX].oneOf.0.on.items.[INDEX].text","typeLabel":"string"}},"uniqueKey":"oneOf.0.anchor.ink.marks.items.[INDEX].oneOf.0.on.items.[INDEX]","typeLabel":"object"},"uniqueKey":"oneOf.0.anchor.ink.marks.items.[INDEX].oneOf.0.on","typeLabel":"object[]"},"start":{"type":"string","maxLength":300,"description":"Measured by a person's browser: selector of the element under a line's first point.","uniqueKey":"oneOf.0.anchor.ink.marks.items.[INDEX].oneOf.0.start","typeLabel":"string"},"end":{"type":"string","maxLength":300,"description":"Measured by a person's browser: selector of the element under a line's last point.","uniqueKey":"oneOf.0.anchor.ink.marks.items.[INDEX].oneOf.0.end","typeLabel":"string"},"line":{"type":"string","enum":["through","under","around"],"description":"Measured by a person's browser: whether the mark runs through or under text, or around something.","uniqueKey":"oneOf.0.anchor.ink.marks.items.[INDEX].oneOf.0.line","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"uniqueKey":"oneOf.0.anchor.ink.marks.items.[INDEX].oneOf.0","typeLabel":"object"},{"type":"object","required":["el","shape"],"properties":{"el":{"type":"string","minLength":1,"maxLength":300,"description":"Selector of the one element the mark is drawn on, in the same shape as an anchor's; html means the whole page (its full scroll size, so one unit is a thousandth of the page). A mark whose element the page does not find exactly once, or that is hidden or clipped away, is not drawn.","isRequired":true,"uniqueKey":"oneOf.0.anchor.ink.marks.items.[INDEX].oneOf.1.el","typeLabel":"string"},"shape":{"type":"string","enum":["ring","box","underline","strike","cross"],"description":"A shape the page draws by hand to fit el's own text, in place of path and write: ring or box around it, underline, strike through it, cross over it. It is stored and read back by its name.","isRequired":true,"uniqueKey":"oneOf.0.anchor.ink.marks.items.[INDEX].oneOf.1.shape","typeLabel":"enum\u003cstring>"},"write":{"type":"string","minLength":1,"maxLength":160,"description":"Words the page writes by hand beside el, in place of path and shape: at most 160 UTF-8 bytes on at most 3 lines split by \\n, cleaned like a comment's text, in printable ASCII and £ € ← ↑ → ↓ ✓ ✗; a character the hand cannot write is refused.","example":"too high?","uniqueKey":"oneOf.0.anchor.ink.marks.items.[INDEX].oneOf.1.write","typeLabel":"string"},"color":{"type":"string","enum":["amber","blue","green","ink","purple","red"],"description":"The mark's colour; amber when left out, and then read back without one.","uniqueKey":"oneOf.0.anchor.ink.marks.items.[INDEX].oneOf.1.color","typeLabel":"enum\u003cstring>"},"path":{"type":"string","maxLength":4000,"pattern":"^M-?\\d+ -?\\d+(?: [ML]-?\\d+ -?\\d+)*$","description":"The strokes in whole thousandths of el's border box: 0 is its left or top edge and 1000 its right or bottom, on each axis on its own, and a number below 0 or past 1000 is outside it, from -100000 to 100000. A move, then lines, a move for each stroke after the first. An underline: M0 1080 L1000 1080.","example":"M0 1080 L1000 1080","uniqueKey":"oneOf.0.anchor.ink.marks.items.[INDEX].oneOf.1.path","typeLabel":"string"},"on":{"type":"array","maxItems":3,"description":"Measured by a person's browser: elements under the mark, the most covered first.","items":{"type":"object","additionalProperties":false,"required":["el","ink"],"properties":{"el":{"type":"string","maxLength":300,"description":"Selector, in the same shape as an anchor's.","isRequired":true,"uniqueKey":"oneOf.0.anchor.ink.marks.items.[INDEX].oneOf.1.on.items.[INDEX].el","typeLabel":"string"},"ink":{"type":"integer","minimum":1,"maximum":100,"description":"Percent of the mark's samples on the element.","isRequired":true,"uniqueKey":"oneOf.0.anchor.ink.marks.items.[INDEX].oneOf.1.on.items.[INDEX].ink","typeLabel":"integer"},"text":{"type":"string","description":"The element's text; the server cuts it to 60 bytes.","uniqueKey":"oneOf.0.anchor.ink.marks.items.[INDEX].oneOf.1.on.items.[INDEX].text","typeLabel":"string"}},"uniqueKey":"oneOf.0.anchor.ink.marks.items.[INDEX].oneOf.1.on.items.[INDEX]","typeLabel":"object"},"uniqueKey":"oneOf.0.anchor.ink.marks.items.[INDEX].oneOf.1.on","typeLabel":"object[]"},"start":{"type":"string","maxLength":300,"description":"Measured by a person's browser: selector of the element under a line's first point.","uniqueKey":"oneOf.0.anchor.ink.marks.items.[INDEX].oneOf.1.start","typeLabel":"string"},"end":{"type":"string","maxLength":300,"description":"Measured by a person's browser: selector of the element under a line's last point.","uniqueKey":"oneOf.0.anchor.ink.marks.items.[INDEX].oneOf.1.end","typeLabel":"string"},"line":{"type":"string","enum":["through","under","around"],"description":"Measured by a person's browser: whether the mark runs through or under text, or around something.","uniqueKey":"oneOf.0.anchor.ink.marks.items.[INDEX].oneOf.1.line","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"uniqueKey":"oneOf.0.anchor.ink.marks.items.[INDEX].oneOf.1","typeLabel":"object"},{"type":"object","required":["el","write"],"properties":{"el":{"type":"string","minLength":1,"maxLength":300,"description":"Selector of the one element the mark is drawn on, in the same shape as an anchor's; html means the whole page (its full scroll size, so one unit is a thousandth of the page). A mark whose element the page does not find exactly once, or that is hidden or clipped away, is not drawn.","isRequired":true,"uniqueKey":"oneOf.0.anchor.ink.marks.items.[INDEX].oneOf.2.el","typeLabel":"string"},"write":{"type":"string","minLength":1,"maxLength":160,"description":"Words the page writes by hand beside el, in place of path and shape: at most 160 UTF-8 bytes on at most 3 lines split by \\n, cleaned like a comment's text, in printable ASCII and £ € ← ↑ → ↓ ✓ ✗; a character the hand cannot write is refused.","example":"too high?","isRequired":true,"uniqueKey":"oneOf.0.anchor.ink.marks.items.[INDEX].oneOf.2.write","typeLabel":"string"},"shape":{"type":"string","enum":["ring","box","underline","strike","cross"],"description":"A shape the page draws by hand to fit el's own text, in place of path and write: ring or box around it, underline, strike through it, cross over it. It is stored and read back by its name.","uniqueKey":"oneOf.0.anchor.ink.marks.items.[INDEX].oneOf.2.shape","typeLabel":"enum\u003cstring>"},"color":{"type":"string","enum":["amber","blue","green","ink","purple","red"],"description":"The mark's colour; amber when left out, and then read back without one.","uniqueKey":"oneOf.0.anchor.ink.marks.items.[INDEX].oneOf.2.color","typeLabel":"enum\u003cstring>"},"path":{"type":"string","maxLength":4000,"pattern":"^M-?\\d+ -?\\d+(?: [ML]-?\\d+ -?\\d+)*$","description":"The strokes in whole thousandths of el's border box: 0 is its left or top edge and 1000 its right or bottom, on each axis on its own, and a number below 0 or past 1000 is outside it, from -100000 to 100000. A move, then lines, a move for each stroke after the first. An underline: M0 1080 L1000 1080.","example":"M0 1080 L1000 1080","uniqueKey":"oneOf.0.anchor.ink.marks.items.[INDEX].oneOf.2.path","typeLabel":"string"},"on":{"type":"array","maxItems":3,"description":"Measured by a person's browser: elements under the mark, the most covered first.","items":{"type":"object","additionalProperties":false,"required":["el","ink"],"properties":{"el":{"type":"string","maxLength":300,"description":"Selector, in the same shape as an anchor's.","isRequired":true,"uniqueKey":"oneOf.0.anchor.ink.marks.items.[INDEX].oneOf.2.on.items.[INDEX].el","typeLabel":"string"},"ink":{"type":"integer","minimum":1,"maximum":100,"description":"Percent of the mark's samples on the element.","isRequired":true,"uniqueKey":"oneOf.0.anchor.ink.marks.items.[INDEX].oneOf.2.on.items.[INDEX].ink","typeLabel":"integer"},"text":{"type":"string","description":"The element's text; the server cuts it to 60 bytes.","uniqueKey":"oneOf.0.anchor.ink.marks.items.[INDEX].oneOf.2.on.items.[INDEX].text","typeLabel":"string"}},"uniqueKey":"oneOf.0.anchor.ink.marks.items.[INDEX].oneOf.2.on.items.[INDEX]","typeLabel":"object"},"uniqueKey":"oneOf.0.anchor.ink.marks.items.[INDEX].oneOf.2.on","typeLabel":"object[]"},"start":{"type":"string","maxLength":300,"description":"Measured by a person's browser: selector of the element under a line's first point.","uniqueKey":"oneOf.0.anchor.ink.marks.items.[INDEX].oneOf.2.start","typeLabel":"string"},"end":{"type":"string","maxLength":300,"description":"Measured by a person's browser: selector of the element under a line's last point.","uniqueKey":"oneOf.0.anchor.ink.marks.items.[INDEX].oneOf.2.end","typeLabel":"string"},"line":{"type":"string","enum":["through","under","around"],"description":"Measured by a person's browser: whether the mark runs through or under text, or around something.","uniqueKey":"oneOf.0.anchor.ink.marks.items.[INDEX].oneOf.2.line","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"uniqueKey":"oneOf.0.anchor.ink.marks.items.[INDEX].oneOf.2","typeLabel":"object"}],"uniqueKey":"oneOf.0.anchor.ink.marks.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"oneOf.0.anchor.ink.marks","typeLabel":"object[]"}},"uniqueKey":"oneOf.0.anchor.ink","typeLabel":"object"},"picture":{"type":"object","additionalProperties":false,"required":["sha256"],"description":"Set by the server, never sent in an anchor: a drawing has a picture of what the person saw where they drew, a PNG of the page around their ink with the ink on it, as the client that sent it drew it. The server keeps the bytes as sent. The pull returns it under pictures with ?pictures=1.","properties":{"sha256":{"type":"string","pattern":"^[0-9a-f]{64}$","description":"Hex SHA-256 of the PNG.","isRequired":true,"uniqueKey":"oneOf.0.anchor.picture.sha256","typeLabel":"string"}},"uniqueKey":"oneOf.0.anchor.picture","typeLabel":"object"},"rect":{"type":"object","additionalProperties":false,"required":["x","y","w","h"],"description":"A box in percent of the page, inside it.","properties":{"x":{"type":"number","minimum":0,"maximum":100,"isRequired":true,"uniqueKey":"oneOf.0.anchor.rect.x","typeLabel":"number"},"y":{"type":"number","minimum":0,"maximum":100,"isRequired":true,"uniqueKey":"oneOf.0.anchor.rect.y","typeLabel":"number"},"w":{"type":"number","minimum":0,"maximum":100,"isRequired":true,"uniqueKey":"oneOf.0.anchor.rect.w","typeLabel":"number"},"h":{"type":"number","minimum":0,"maximum":100,"isRequired":true,"uniqueKey":"oneOf.0.anchor.rect.h","typeLabel":"number"}},"conditionalRequirements":[{}],"uniqueKey":"oneOf.0.anchor.rect","typeLabel":"object"},"scroll_y":{"type":"number","minimum":0,"maximum":10000000,"description":"Scroll offset of the page in pixels when the comment was left.","uniqueKey":"oneOf.0.anchor.scroll_y","typeLabel":"number"}},"conditionallyRequiredProperties":{"rect":[{}]},"isRequired":true,"uniqueKey":"oneOf.0.anchor","typeLabel":"object"},"thread":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["by","text","at"],"properties":{"by":{"type":"string","enum":["owner","participant","agent"],"description":"participant is a person other than the owner; agent is an agent, with owner or participant rights decided by the host.","isRequired":true,"uniqueKey":"oneOf.0.thread.items.[INDEX].by","typeLabel":"enum\u003cstring>"},"text":{"type":"string","isRequired":true,"uniqueKey":"oneOf.0.thread.items.[INDEX].text","typeLabel":"string"},"at":{"type":"string","format":"date-time","isRequired":true,"uniqueKey":"oneOf.0.thread.items.[INDEX].at","typeLabel":"string\u003cdate-time>"},"who":{"type":"string","maxLength":64,"pattern":"^(member:[0-9]+|computer:.+)$","description":"A person is member:\u003cid>, resolved through the board people. A shared runtime agent is computer:\u003cid>, displayed by its agent name and retained for retraction and per-person thread limits. Absent for an owner-authorized agent.","uniqueKey":"oneOf.0.thread.items.[INDEX].who","typeLabel":"string"},"agent":{"type":"string","maxLength":64,"description":"An agent's name, such as Operator or the MCP client's own name (Agent when it gave none or a reserved one). Absent for people, on an answer sent through the HTTP resolve route or the CLI, which name no agent, and on agent messages written before agents were named.","uniqueKey":"oneOf.0.thread.items.[INDEX].agent","typeLabel":"string"},"resolved":{"type":"string","enum":["done","asked"],"description":"On an agent's answer or the owner marking a comment done: the resulting state. A message without it, an agent's included, answers nothing.","uniqueKey":"oneOf.0.thread.items.[INDEX].resolved","typeLabel":"enum\u003cstring>"},"files":{"type":"array","items":{"type":"string","uniqueKey":"oneOf.0.thread.items.[INDEX].files.items.[INDEX]","typeLabel":"string"},"description":"On an agent's answer only: the paths of the files it says it changed.","uniqueKey":"oneOf.0.thread.items.[INDEX].files","typeLabel":"string[]"},"request":{"type":"string","pattern":"^[0-9a-f]{24}$","description":"On a comment's first message, a reply or an owner's answer whose client named it (CreateCommentRequest.request, ReplyCommentRequest.request, ReopenCommentRequest.request) only, so the same write sent again is stored once. Agents never read it.","uniqueKey":"oneOf.0.thread.items.[INDEX].request","typeLabel":"string"}},"uniqueKey":"oneOf.0.thread.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"oneOf.0.thread","typeLabel":"object[]"},"created_at":{"type":"string","format":"date-time","isRequired":true,"uniqueKey":"oneOf.0.created_at","typeLabel":"string\u003cdate-time>"},"updated_at":{"type":"string","format":"date-time","isRequired":true,"uniqueKey":"oneOf.0.updated_at","typeLabel":"string\u003cdate-time>"},"fixed_in_release":{"type":"integer","description":"Release that fixed the comment, when a newer one was published.","uniqueKey":"oneOf.0.fixed_in_release","typeLabel":"integer"}},"additionalProperties":false,"uniqueKey":"oneOf.0","typeLabel":"object"},{"type":"object","required":["id","state","version","release","anchor","thread"],"properties":{"id":{"type":"string","example":"comment_1a2b3c","isRequired":true,"uniqueKey":"oneOf.1.id","typeLabel":"string"},"state":{"type":"string","enum":["open","asked","done"],"description":"open waits for an agent to answer it, asked waits for the owner's answer, done is finished.","isRequired":true,"uniqueKey":"oneOf.1.state","typeLabel":"enum\u003cstring>"},"version":{"type":"integer","minimum":1,"description":"Changes on every update; send the one you read when resolving.","isRequired":true,"uniqueKey":"oneOf.1.version","typeLabel":"integer"},"release":{"type":"integer","description":"Release the computer served when the comment was left; 0 when it served none.","isRequired":true,"uniqueKey":"oneOf.1.release","typeLabel":"integer"},"anchor":{"type":"object","additionalProperties":false,"required":["kind","page"],"description":"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.","properties":{"kind":{"type":"string","enum":["element","area"],"isRequired":true,"uniqueKey":"oneOf.1.anchor.kind","typeLabel":"enum\u003cstring>"},"page":{"type":"string","maxLength":500,"description":"Path of the page, starting with /. The server stores it as the page's key, by the page rules of the comments contract that the page's comment script applies too: it is percent-encoded as a browser's location writes it (non-ASCII as UTF-8, hex in upper case, no escape decoded, so /café is stored as /caf%C3%A9), query parameters whose names hold a credential name are removed, path segments that look like tokens (a compact JWT, or a long run of URL-safe characters with a digit) become :token, a hash is kept only when it is a #/ or #! route (keyed the same way), and a key over maxLength keeps its path alone, without its query or hash. So /preview/\u003ctoken>?token=x\u0026lang=en is stored as /preview/:token?lang=en.","example":"/menu","isRequired":true,"uniqueKey":"oneOf.1.anchor.page","typeLabel":"string"},"selector":{"type":"string","maxLength":300,"description":"Selector the comment script made: steps of a tag, #id or [id=\"x\"], up to two .classes, [data-testid=\"x\"] and :nth-of-type(n), joined by \" > \", at most 12 steps and maxLength bytes. Required for an element. For an area with ink it is the first mark's el, filled in when left out.","example":"section > a.cta","uniqueKey":"oneOf.1.anchor.selector","typeLabel":"string"},"text":{"type":"string","description":"Text near the anchor; the server cuts it to 200 bytes.","uniqueKey":"oneOf.1.anchor.text","typeLabel":"string"},"label":{"type":"string","description":"Accessible label of the element; the server cuts it to 120 bytes.","uniqueKey":"oneOf.1.anchor.label","typeLabel":"string"},"ink":{"type":"object","additionalProperties":false,"required":["marks"],"description":"A drawing on the page, only on an area anchor: marks, each on one element and drawn relative to it, so a drawing lands in the same place on every screen. A mark is exactly one of path (strokes in the element's own box), shape (a named shape the page draws by hand) or write (words the page writes beside the element), with an optional color. A person's browser sends only paths, which also carry what it measured (on, start, end, line). At most 64000 bytes as JSON.","properties":{"marks":{"type":"array","minItems":1,"maxItems":20,"items":{"oneOf":[{"type":"object","required":["el","path"],"properties":{"el":{"type":"string","minLength":1,"maxLength":300,"description":"Selector of the one element the mark is drawn on, in the same shape as an anchor's; html means the whole page (its full scroll size, so one unit is a thousandth of the page). A mark whose element the page does not find exactly once, or that is hidden or clipped away, is not drawn.","isRequired":true,"uniqueKey":"oneOf.1.anchor.ink.marks.items.[INDEX].oneOf.0.el","typeLabel":"string"},"path":{"type":"string","maxLength":4000,"pattern":"^M-?\\d+ -?\\d+(?: [ML]-?\\d+ -?\\d+)*$","description":"The strokes in whole thousandths of el's border box: 0 is its left or top edge and 1000 its right or bottom, on each axis on its own, and a number below 0 or past 1000 is outside it, from -100000 to 100000. A move, then lines, a move for each stroke after the first. An underline: M0 1080 L1000 1080.","example":"M0 1080 L1000 1080","isRequired":true,"uniqueKey":"oneOf.1.anchor.ink.marks.items.[INDEX].oneOf.0.path","typeLabel":"string"},"shape":{"type":"string","enum":["ring","box","underline","strike","cross"],"description":"A shape the page draws by hand to fit el's own text, in place of path and write: ring or box around it, underline, strike through it, cross over it. It is stored and read back by its name.","uniqueKey":"oneOf.1.anchor.ink.marks.items.[INDEX].oneOf.0.shape","typeLabel":"enum\u003cstring>"},"write":{"type":"string","minLength":1,"maxLength":160,"description":"Words the page writes by hand beside el, in place of path and shape: at most 160 UTF-8 bytes on at most 3 lines split by \\n, cleaned like a comment's text, in printable ASCII and £ € ← ↑ → ↓ ✓ ✗; a character the hand cannot write is refused.","example":"too high?","uniqueKey":"oneOf.1.anchor.ink.marks.items.[INDEX].oneOf.0.write","typeLabel":"string"},"color":{"type":"string","enum":["amber","blue","green","ink","purple","red"],"description":"The mark's colour; amber when left out, and then read back without one.","uniqueKey":"oneOf.1.anchor.ink.marks.items.[INDEX].oneOf.0.color","typeLabel":"enum\u003cstring>"},"on":{"type":"array","maxItems":3,"description":"Measured by a person's browser: elements under the mark, the most covered first.","items":{"type":"object","additionalProperties":false,"required":["el","ink"],"properties":{"el":{"type":"string","maxLength":300,"description":"Selector, in the same shape as an anchor's.","isRequired":true,"uniqueKey":"oneOf.1.anchor.ink.marks.items.[INDEX].oneOf.0.on.items.[INDEX].el","typeLabel":"string"},"ink":{"type":"integer","minimum":1,"maximum":100,"description":"Percent of the mark's samples on the element.","isRequired":true,"uniqueKey":"oneOf.1.anchor.ink.marks.items.[INDEX].oneOf.0.on.items.[INDEX].ink","typeLabel":"integer"},"text":{"type":"string","description":"The element's text; the server cuts it to 60 bytes.","uniqueKey":"oneOf.1.anchor.ink.marks.items.[INDEX].oneOf.0.on.items.[INDEX].text","typeLabel":"string"}},"uniqueKey":"oneOf.1.anchor.ink.marks.items.[INDEX].oneOf.0.on.items.[INDEX]","typeLabel":"object"},"uniqueKey":"oneOf.1.anchor.ink.marks.items.[INDEX].oneOf.0.on","typeLabel":"object[]"},"start":{"type":"string","maxLength":300,"description":"Measured by a person's browser: selector of the element under a line's first point.","uniqueKey":"oneOf.1.anchor.ink.marks.items.[INDEX].oneOf.0.start","typeLabel":"string"},"end":{"type":"string","maxLength":300,"description":"Measured by a person's browser: selector of the element under a line's last point.","uniqueKey":"oneOf.1.anchor.ink.marks.items.[INDEX].oneOf.0.end","typeLabel":"string"},"line":{"type":"string","enum":["through","under","around"],"description":"Measured by a person's browser: whether the mark runs through or under text, or around something.","uniqueKey":"oneOf.1.anchor.ink.marks.items.[INDEX].oneOf.0.line","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"uniqueKey":"oneOf.1.anchor.ink.marks.items.[INDEX].oneOf.0","typeLabel":"object"},{"type":"object","required":["el","shape"],"properties":{"el":{"type":"string","minLength":1,"maxLength":300,"description":"Selector of the one element the mark is drawn on, in the same shape as an anchor's; html means the whole page (its full scroll size, so one unit is a thousandth of the page). A mark whose element the page does not find exactly once, or that is hidden or clipped away, is not drawn.","isRequired":true,"uniqueKey":"oneOf.1.anchor.ink.marks.items.[INDEX].oneOf.1.el","typeLabel":"string"},"shape":{"type":"string","enum":["ring","box","underline","strike","cross"],"description":"A shape the page draws by hand to fit el's own text, in place of path and write: ring or box around it, underline, strike through it, cross over it. It is stored and read back by its name.","isRequired":true,"uniqueKey":"oneOf.1.anchor.ink.marks.items.[INDEX].oneOf.1.shape","typeLabel":"enum\u003cstring>"},"write":{"type":"string","minLength":1,"maxLength":160,"description":"Words the page writes by hand beside el, in place of path and shape: at most 160 UTF-8 bytes on at most 3 lines split by \\n, cleaned like a comment's text, in printable ASCII and £ € ← ↑ → ↓ ✓ ✗; a character the hand cannot write is refused.","example":"too high?","uniqueKey":"oneOf.1.anchor.ink.marks.items.[INDEX].oneOf.1.write","typeLabel":"string"},"color":{"type":"string","enum":["amber","blue","green","ink","purple","red"],"description":"The mark's colour; amber when left out, and then read back without one.","uniqueKey":"oneOf.1.anchor.ink.marks.items.[INDEX].oneOf.1.color","typeLabel":"enum\u003cstring>"},"path":{"type":"string","maxLength":4000,"pattern":"^M-?\\d+ -?\\d+(?: [ML]-?\\d+ -?\\d+)*$","description":"The strokes in whole thousandths of el's border box: 0 is its left or top edge and 1000 its right or bottom, on each axis on its own, and a number below 0 or past 1000 is outside it, from -100000 to 100000. A move, then lines, a move for each stroke after the first. An underline: M0 1080 L1000 1080.","example":"M0 1080 L1000 1080","uniqueKey":"oneOf.1.anchor.ink.marks.items.[INDEX].oneOf.1.path","typeLabel":"string"},"on":{"type":"array","maxItems":3,"description":"Measured by a person's browser: elements under the mark, the most covered first.","items":{"type":"object","additionalProperties":false,"required":["el","ink"],"properties":{"el":{"type":"string","maxLength":300,"description":"Selector, in the same shape as an anchor's.","isRequired":true,"uniqueKey":"oneOf.1.anchor.ink.marks.items.[INDEX].oneOf.1.on.items.[INDEX].el","typeLabel":"string"},"ink":{"type":"integer","minimum":1,"maximum":100,"description":"Percent of the mark's samples on the element.","isRequired":true,"uniqueKey":"oneOf.1.anchor.ink.marks.items.[INDEX].oneOf.1.on.items.[INDEX].ink","typeLabel":"integer"},"text":{"type":"string","description":"The element's text; the server cuts it to 60 bytes.","uniqueKey":"oneOf.1.anchor.ink.marks.items.[INDEX].oneOf.1.on.items.[INDEX].text","typeLabel":"string"}},"uniqueKey":"oneOf.1.anchor.ink.marks.items.[INDEX].oneOf.1.on.items.[INDEX]","typeLabel":"object"},"uniqueKey":"oneOf.1.anchor.ink.marks.items.[INDEX].oneOf.1.on","typeLabel":"object[]"},"start":{"type":"string","maxLength":300,"description":"Measured by a person's browser: selector of the element under a line's first point.","uniqueKey":"oneOf.1.anchor.ink.marks.items.[INDEX].oneOf.1.start","typeLabel":"string"},"end":{"type":"string","maxLength":300,"description":"Measured by a person's browser: selector of the element under a line's last point.","uniqueKey":"oneOf.1.anchor.ink.marks.items.[INDEX].oneOf.1.end","typeLabel":"string"},"line":{"type":"string","enum":["through","under","around"],"description":"Measured by a person's browser: whether the mark runs through or under text, or around something.","uniqueKey":"oneOf.1.anchor.ink.marks.items.[INDEX].oneOf.1.line","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"uniqueKey":"oneOf.1.anchor.ink.marks.items.[INDEX].oneOf.1","typeLabel":"object"},{"type":"object","required":["el","write"],"properties":{"el":{"type":"string","minLength":1,"maxLength":300,"description":"Selector of the one element the mark is drawn on, in the same shape as an anchor's; html means the whole page (its full scroll size, so one unit is a thousandth of the page). A mark whose element the page does not find exactly once, or that is hidden or clipped away, is not drawn.","isRequired":true,"uniqueKey":"oneOf.1.anchor.ink.marks.items.[INDEX].oneOf.2.el","typeLabel":"string"},"write":{"type":"string","minLength":1,"maxLength":160,"description":"Words the page writes by hand beside el, in place of path and shape: at most 160 UTF-8 bytes on at most 3 lines split by \\n, cleaned like a comment's text, in printable ASCII and £ € ← ↑ → ↓ ✓ ✗; a character the hand cannot write is refused.","example":"too high?","isRequired":true,"uniqueKey":"oneOf.1.anchor.ink.marks.items.[INDEX].oneOf.2.write","typeLabel":"string"},"shape":{"type":"string","enum":["ring","box","underline","strike","cross"],"description":"A shape the page draws by hand to fit el's own text, in place of path and write: ring or box around it, underline, strike through it, cross over it. It is stored and read back by its name.","uniqueKey":"oneOf.1.anchor.ink.marks.items.[INDEX].oneOf.2.shape","typeLabel":"enum\u003cstring>"},"color":{"type":"string","enum":["amber","blue","green","ink","purple","red"],"description":"The mark's colour; amber when left out, and then read back without one.","uniqueKey":"oneOf.1.anchor.ink.marks.items.[INDEX].oneOf.2.color","typeLabel":"enum\u003cstring>"},"path":{"type":"string","maxLength":4000,"pattern":"^M-?\\d+ -?\\d+(?: [ML]-?\\d+ -?\\d+)*$","description":"The strokes in whole thousandths of el's border box: 0 is its left or top edge and 1000 its right or bottom, on each axis on its own, and a number below 0 or past 1000 is outside it, from -100000 to 100000. A move, then lines, a move for each stroke after the first. An underline: M0 1080 L1000 1080.","example":"M0 1080 L1000 1080","uniqueKey":"oneOf.1.anchor.ink.marks.items.[INDEX].oneOf.2.path","typeLabel":"string"},"on":{"type":"array","maxItems":3,"description":"Measured by a person's browser: elements under the mark, the most covered first.","items":{"type":"object","additionalProperties":false,"required":["el","ink"],"properties":{"el":{"type":"string","maxLength":300,"description":"Selector, in the same shape as an anchor's.","isRequired":true,"uniqueKey":"oneOf.1.anchor.ink.marks.items.[INDEX].oneOf.2.on.items.[INDEX].el","typeLabel":"string"},"ink":{"type":"integer","minimum":1,"maximum":100,"description":"Percent of the mark's samples on the element.","isRequired":true,"uniqueKey":"oneOf.1.anchor.ink.marks.items.[INDEX].oneOf.2.on.items.[INDEX].ink","typeLabel":"integer"},"text":{"type":"string","description":"The element's text; the server cuts it to 60 bytes.","uniqueKey":"oneOf.1.anchor.ink.marks.items.[INDEX].oneOf.2.on.items.[INDEX].text","typeLabel":"string"}},"uniqueKey":"oneOf.1.anchor.ink.marks.items.[INDEX].oneOf.2.on.items.[INDEX]","typeLabel":"object"},"uniqueKey":"oneOf.1.anchor.ink.marks.items.[INDEX].oneOf.2.on","typeLabel":"object[]"},"start":{"type":"string","maxLength":300,"description":"Measured by a person's browser: selector of the element under a line's first point.","uniqueKey":"oneOf.1.anchor.ink.marks.items.[INDEX].oneOf.2.start","typeLabel":"string"},"end":{"type":"string","maxLength":300,"description":"Measured by a person's browser: selector of the element under a line's last point.","uniqueKey":"oneOf.1.anchor.ink.marks.items.[INDEX].oneOf.2.end","typeLabel":"string"},"line":{"type":"string","enum":["through","under","around"],"description":"Measured by a person's browser: whether the mark runs through or under text, or around something.","uniqueKey":"oneOf.1.anchor.ink.marks.items.[INDEX].oneOf.2.line","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"uniqueKey":"oneOf.1.anchor.ink.marks.items.[INDEX].oneOf.2","typeLabel":"object"}],"uniqueKey":"oneOf.1.anchor.ink.marks.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"oneOf.1.anchor.ink.marks","typeLabel":"object[]"}},"uniqueKey":"oneOf.1.anchor.ink","typeLabel":"object"},"picture":{"type":"object","additionalProperties":false,"required":["sha256"],"description":"Set by the server, never sent in an anchor: a drawing has a picture of what the person saw where they drew, a PNG of the page around their ink with the ink on it, as the client that sent it drew it. The server keeps the bytes as sent. The pull returns it under pictures with ?pictures=1.","properties":{"sha256":{"type":"string","pattern":"^[0-9a-f]{64}$","description":"Hex SHA-256 of the PNG.","isRequired":true,"uniqueKey":"oneOf.1.anchor.picture.sha256","typeLabel":"string"}},"uniqueKey":"oneOf.1.anchor.picture","typeLabel":"object"},"rect":{"type":"object","additionalProperties":false,"required":["x","y","w","h"],"description":"A box in percent of the page, inside it.","properties":{"x":{"type":"number","minimum":0,"maximum":100,"isRequired":true,"uniqueKey":"oneOf.1.anchor.rect.x","typeLabel":"number"},"y":{"type":"number","minimum":0,"maximum":100,"isRequired":true,"uniqueKey":"oneOf.1.anchor.rect.y","typeLabel":"number"},"w":{"type":"number","minimum":0,"maximum":100,"isRequired":true,"uniqueKey":"oneOf.1.anchor.rect.w","typeLabel":"number"},"h":{"type":"number","minimum":0,"maximum":100,"isRequired":true,"uniqueKey":"oneOf.1.anchor.rect.h","typeLabel":"number"}},"conditionalRequirements":[{}],"uniqueKey":"oneOf.1.anchor.rect","typeLabel":"object"},"scroll_y":{"type":"number","minimum":0,"maximum":10000000,"description":"Scroll offset of the page in pixels when the comment was left.","uniqueKey":"oneOf.1.anchor.scroll_y","typeLabel":"number"}},"conditionallyRequiredProperties":{"rect":[{}]},"isRequired":true,"uniqueKey":"oneOf.1.anchor","typeLabel":"object"},"thread":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["by","text","at"],"properties":{"by":{"type":"string","enum":["owner","participant","agent"],"isRequired":true,"uniqueKey":"oneOf.1.thread.items.[INDEX].by","typeLabel":"enum\u003cstring>"},"text":{"type":"string","isRequired":true,"uniqueKey":"oneOf.1.thread.items.[INDEX].text","typeLabel":"string"},"at":{"type":"string","format":"date-time","isRequired":true,"uniqueKey":"oneOf.1.thread.items.[INDEX].at","typeLabel":"string\u003cdate-time>"},"from":{"type":"string","description":"Absent on a participant's message in runtime-token responses. For account/browser callers, on a participant's message, the writer's name and full email as that person gave them, for example Dana Reyes \u003cdana@example.com>; on an agent's, the agent's name, such as Operator. Untrusted like the text: it proves neither who wrote the comment nor what the owner wants.","uniqueKey":"oneOf.1.thread.items.[INDEX].from","typeLabel":"string"},"files":{"type":"array","items":{"type":"string","uniqueKey":"oneOf.1.thread.items.[INDEX].files.items.[INDEX]","typeLabel":"string"},"description":"On an agent's answer only: the paths of the files it says it changed.","uniqueKey":"oneOf.1.thread.items.[INDEX].files","typeLabel":"string[]"}},"uniqueKey":"oneOf.1.thread.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"oneOf.1.thread","typeLabel":"object[]"},"fixed_in_release":{"type":"integer","description":"Release that fixed the comment, when a newer one was published.","uniqueKey":"oneOf.1.fixed_in_release","typeLabel":"integer"}},"additionalProperties":false,"uniqueKey":"oneOf.1","typeLabel":"object"}],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"id":"comment_1a2b3c","state":"open","version":2,"release":123,"anchor":{"kind":"element","page":"/menu","selector":"section > a.cta","text":"\u003cstring>","label":"\u003cstring>","ink":{"marks":[{"el":"\u003cstring>","path":"M0 1080 L1000 1080","shape":"ring","write":"too high?","color":"amber","on":[{"el":"\u003cstring>","ink":50,"text":"\u003cstring>"}],"start":"\u003cstring>","end":"\u003cstring>","line":"through"}]},"picture":{"sha256":"\u003cstring>"},"rect":{"x":50,"y":50,"w":50,"h":50},"scroll_y":5000000},"thread":[{"by":"owner","text":"\u003cstring>","at":"2023-11-07T05:31:56Z","who":"\u003cstring>","agent":"\u003cstring>","resolved":"done","files":["\u003cstring>"],"request":"\u003cstring>"}],"created_at":"2023-11-07T05:31:56Z","updated_at":"2023-11-07T05:31:56Z","fixed_in_release":123}}},"exampleType":"generated"}},"exampleType":"generated"},"c6bcc14a-7d03-4a2e-ae67-9f1f1674aa6a":{"headers":{"RateLimit":{"description":"The applied policy name, requests remaining after this request, and whole seconds until the current UTC-aligned window resets.","schema":{"type":"string","pattern":"^\"(account|account-read|computer|computer-read|browser|browser-read|document|source|comment-board|comment-live|comment-write)\";r=[0-9]+;t=([1-9]|[1-5][0-9]|60)$","examples":["\"account\";r=599;t=42","\"computer-read\";r=598;t=42"]}},"RateLimit-Policy":{"description":"The selected policy name, quota, and window in seconds. Valid account credentials use account or account-read with q=600, computer credentials use computer or computer-read with q=600, a browser session uses browser or browser-read with q=600 on the website's same-origin requests and document with q=600 on document routes, unauthenticated or unrecognized requests use source with q=60 for their source IP, a request without an Authorization header reading a comment board uses comment-board with q=300 for its source IP, writing to comments (the comment layer's writes and steps) uses comment-write with q=60 for its source IP, and a browser session's handshake of a comment live channel uses comment-live with q=60 for its source IP.","schema":{"type":"string","pattern":"^(\"(account|account-read|computer|computer-read|browser|browser-read|document)\";q=600|\"(source|comment-live|comment-write)\";q=60|\"comment-board\";q=300);w=60$","examples":["\"account\";q=600;w=60","\"computer-read\";q=600;w=60"]}}},"description":"Bad Request. `invalid_comment`: fix the comment or its anchor and send it again.","content":{"application/problem+json":{"schema":{"type":"object","additionalProperties":false,"required":["type","title","status","code","detail"],"properties":{"type":{"type":"string","format":"uri","description":"https://cool.computer/docs/api-reference/errors, the page that explains every code.","isRequired":true,"uniqueKey":"type","typeLabel":"string\u003curi>"},"title":{"type":"string","isRequired":true,"uniqueKey":"title","typeLabel":"string"},"status":{"type":"integer","minimum":400,"maximum":599,"isRequired":true,"uniqueKey":"status","typeLabel":"integer"},"code":{"type":"string","pattern":"^[a-z0-9_]+$","isRequired":true,"uniqueKey":"code","typeLabel":"string"},"detail":{"type":"string","isRequired":true,"uniqueKey":"detail","typeLabel":"string"},"resolution":{"type":"string","uniqueKey":"resolution","typeLabel":"string"},"context":{"type":"object","additionalProperties":true,"uniqueKey":"context","typeLabel":"object"},"suggestions":{"type":"array","items":{"type":"string","uniqueKey":"suggestions.items.[INDEX]","typeLabel":"string"},"maxItems":3,"description":"Values to send instead. With name_taken: up to three free names made from the requested one, the first with a random suffix; each was free when the answer was made.","uniqueKey":"suggestions","typeLabel":"string[]"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"type":"\u003cstring>","title":"\u003cstring>","status":499,"code":"\u003cstring>","detail":"\u003cstring>","resolution":"\u003cstring>","context":{},"suggestions":["\u003cstring>"]}}},"exampleType":"generated"}},"exampleType":"generated"},"77448393-28c3-4c76-929e-a6c68a3bf70f":{"headers":{"RateLimit":{"description":"The applied policy name, requests remaining after this request, and whole seconds until the current UTC-aligned window resets.","schema":{"type":"string","pattern":"^\"(account|account-read|computer|computer-read|browser|browser-read|document|source|comment-board|comment-live|comment-write)\";r=[0-9]+;t=([1-9]|[1-5][0-9]|60)$","examples":["\"account\";r=599;t=42","\"computer-read\";r=598;t=42"]}},"RateLimit-Policy":{"description":"The selected policy name, quota, and window in seconds. Valid account credentials use account or account-read with q=600, computer credentials use computer or computer-read with q=600, a browser session uses browser or browser-read with q=600 on the website's same-origin requests and document with q=600 on document routes, unauthenticated or unrecognized requests use source with q=60 for their source IP, a request without an Authorization header reading a comment board uses comment-board with q=300 for its source IP, writing to comments (the comment layer's writes and steps) uses comment-write with q=60 for its source IP, and a browser session's handshake of a comment live channel uses comment-live with q=60 for its source IP.","schema":{"type":"string","pattern":"^(\"(account|account-read|computer|computer-read|browser|browser-read|document)\";q=600|\"(source|comment-live|comment-write)\";q=60|\"comment-board\";q=300);w=60$","examples":["\"account\";q=600;w=60","\"computer-read\";q=600;w=60"]}}},"description":"Unauthorized.","content":{"application/problem+json":{"schema":{"type":"object","additionalProperties":false,"required":["type","title","status","code","detail"],"properties":{"type":{"type":"string","format":"uri","description":"https://cool.computer/docs/api-reference/errors, the page that explains every code.","isRequired":true,"uniqueKey":"type","typeLabel":"string\u003curi>"},"title":{"type":"string","isRequired":true,"uniqueKey":"title","typeLabel":"string"},"status":{"type":"integer","minimum":400,"maximum":599,"isRequired":true,"uniqueKey":"status","typeLabel":"integer"},"code":{"type":"string","pattern":"^[a-z0-9_]+$","isRequired":true,"uniqueKey":"code","typeLabel":"string"},"detail":{"type":"string","isRequired":true,"uniqueKey":"detail","typeLabel":"string"},"resolution":{"type":"string","uniqueKey":"resolution","typeLabel":"string"},"context":{"type":"object","additionalProperties":true,"uniqueKey":"context","typeLabel":"object"},"suggestions":{"type":"array","items":{"type":"string","uniqueKey":"suggestions.items.[INDEX]","typeLabel":"string"},"maxItems":3,"description":"Values to send instead. With name_taken: up to three free names made from the requested one, the first with a random suffix; each was free when the answer was made.","uniqueKey":"suggestions","typeLabel":"string[]"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"type":"\u003cstring>","title":"\u003cstring>","status":499,"code":"\u003cstring>","detail":"\u003cstring>","resolution":"\u003cstring>","context":{},"suggestions":["\u003cstring>"]}}},"exampleType":"generated"}},"exampleType":"generated"},"965525ea-b79a-4fce-94e0-dfbcc565ef85":{"headers":{"RateLimit":{"description":"The applied policy name, requests remaining after this request, and whole seconds until the current UTC-aligned window resets.","schema":{"type":"string","pattern":"^\"(account|account-read|computer|computer-read|browser|browser-read|document|source|comment-board|comment-live|comment-write)\";r=[0-9]+;t=([1-9]|[1-5][0-9]|60)$","examples":["\"account\";r=599;t=42","\"computer-read\";r=598;t=42"]}},"RateLimit-Policy":{"description":"The selected policy name, quota, and window in seconds. Valid account credentials use account or account-read with q=600, computer credentials use computer or computer-read with q=600, a browser session uses browser or browser-read with q=600 on the website's same-origin requests and document with q=600 on document routes, unauthenticated or unrecognized requests use source with q=60 for their source IP, a request without an Authorization header reading a comment board uses comment-board with q=300 for its source IP, writing to comments (the comment layer's writes and steps) uses comment-write with q=60 for its source IP, and a browser session's handshake of a comment live channel uses comment-live with q=60 for its source IP.","schema":{"type":"string","pattern":"^(\"(account|account-read|computer|computer-read|browser|browser-read|document)\";q=600|\"(source|comment-live|comment-write)\";q=60|\"comment-board\";q=300);w=60$","examples":["\"account\";q=600;w=60","\"computer-read\";q=600;w=60"]}}},"description":"Not Found. `comments_off`: comments are off for the computer; ask the owner to turn them on, or, as the owner, PUT /api/computers/{id}/comment-settings. `comment_not_found`: read the comments again, the comment may have been deleted or retracted. The computer itself is also 404 for anyone it is not shared with when it is private.","content":{"application/problem+json":{"schema":{"type":"object","additionalProperties":false,"required":["type","title","status","code","detail"],"properties":{"type":{"type":"string","format":"uri","description":"https://cool.computer/docs/api-reference/errors, the page that explains every code.","isRequired":true,"uniqueKey":"type","typeLabel":"string\u003curi>"},"title":{"type":"string","isRequired":true,"uniqueKey":"title","typeLabel":"string"},"status":{"type":"integer","minimum":400,"maximum":599,"isRequired":true,"uniqueKey":"status","typeLabel":"integer"},"code":{"type":"string","pattern":"^[a-z0-9_]+$","isRequired":true,"uniqueKey":"code","typeLabel":"string"},"detail":{"type":"string","isRequired":true,"uniqueKey":"detail","typeLabel":"string"},"resolution":{"type":"string","uniqueKey":"resolution","typeLabel":"string"},"context":{"type":"object","additionalProperties":true,"uniqueKey":"context","typeLabel":"object"},"suggestions":{"type":"array","items":{"type":"string","uniqueKey":"suggestions.items.[INDEX]","typeLabel":"string"},"maxItems":3,"description":"Values to send instead. With name_taken: up to three free names made from the requested one, the first with a random suffix; each was free when the answer was made.","uniqueKey":"suggestions","typeLabel":"string[]"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"type":"\u003cstring>","title":"\u003cstring>","status":499,"code":"\u003cstring>","detail":"\u003cstring>","resolution":"\u003cstring>","context":{},"suggestions":["\u003cstring>"]}}},"exampleType":"generated"}},"exampleType":"generated"},"79801249-74bc-444b-b49e-a4fbb393e615":{"headers":{"RateLimit":{"description":"The applied policy name, requests remaining after this request, and whole seconds until the current UTC-aligned window resets.","schema":{"type":"string","pattern":"^\"(account|account-read|computer|computer-read|browser|browser-read|document|source|comment-board|comment-live|comment-write)\";r=[0-9]+;t=([1-9]|[1-5][0-9]|60)$","examples":["\"account\";r=599;t=42","\"computer-read\";r=598;t=42"]}},"RateLimit-Policy":{"description":"The selected policy name, quota, and window in seconds. Valid account credentials use account or account-read with q=600, computer credentials use computer or computer-read with q=600, a browser session uses browser or browser-read with q=600 on the website's same-origin requests and document with q=600 on document routes, unauthenticated or unrecognized requests use source with q=60 for their source IP, a request without an Authorization header reading a comment board uses comment-board with q=300 for its source IP, writing to comments (the comment layer's writes and steps) uses comment-write with q=60 for its source IP, and a browser session's handshake of a comment live channel uses comment-live with q=60 for its source IP.","schema":{"type":"string","pattern":"^(\"(account|account-read|computer|computer-read|browser|browser-read|document)\";q=600|\"(source|comment-live|comment-write)\";q=60|\"comment-board\";q=300);w=60$","examples":["\"account\";q=600;w=60","\"computer-read\";q=600;w=60"]}}},"description":"Request Entity Too Large. `comment_too_large`: shorten the comment.","content":{"application/problem+json":{"schema":{"type":"object","additionalProperties":false,"required":["type","title","status","code","detail"],"properties":{"type":{"type":"string","format":"uri","description":"https://cool.computer/docs/api-reference/errors, the page that explains every code.","isRequired":true,"uniqueKey":"type","typeLabel":"string\u003curi>"},"title":{"type":"string","isRequired":true,"uniqueKey":"title","typeLabel":"string"},"status":{"type":"integer","minimum":400,"maximum":599,"isRequired":true,"uniqueKey":"status","typeLabel":"integer"},"code":{"type":"string","pattern":"^[a-z0-9_]+$","isRequired":true,"uniqueKey":"code","typeLabel":"string"},"detail":{"type":"string","isRequired":true,"uniqueKey":"detail","typeLabel":"string"},"resolution":{"type":"string","uniqueKey":"resolution","typeLabel":"string"},"context":{"type":"object","additionalProperties":true,"uniqueKey":"context","typeLabel":"object"},"suggestions":{"type":"array","items":{"type":"string","uniqueKey":"suggestions.items.[INDEX]","typeLabel":"string"},"maxItems":3,"description":"Values to send instead. With name_taken: up to three free names made from the requested one, the first with a random suffix; each was free when the answer was made.","uniqueKey":"suggestions","typeLabel":"string[]"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"type":"\u003cstring>","title":"\u003cstring>","status":499,"code":"\u003cstring>","detail":"\u003cstring>","resolution":"\u003cstring>","context":{},"suggestions":["\u003cstring>"]}}},"exampleType":"generated"}},"exampleType":"generated"},"eab5bd72-4236-4ac1-aff1-2aea2e23d426":{"headers":{"RateLimit":{"description":"The applied policy name, requests remaining after this request, and whole seconds until the current UTC-aligned window resets.","schema":{"type":"string","pattern":"^\"(account|account-read|computer|computer-read|browser|browser-read|document|source|comment-board|comment-live|comment-write)\";r=[0-9]+;t=([1-9]|[1-5][0-9]|60)$","examples":["\"account\";r=599;t=42","\"computer-read\";r=598;t=42"]}},"RateLimit-Policy":{"description":"The selected policy name, quota, and window in seconds. Valid account credentials use account or account-read with q=600, computer credentials use computer or computer-read with q=600, a browser session uses browser or browser-read with q=600 on the website's same-origin requests and document with q=600 on document routes, unauthenticated or unrecognized requests use source with q=60 for their source IP, a request without an Authorization header reading a comment board uses comment-board with q=300 for its source IP, writing to comments (the comment layer's writes and steps) uses comment-write with q=60 for its source IP, and a browser session's handshake of a comment live channel uses comment-live with q=60 for its source IP.","schema":{"type":"string","pattern":"^(\"(account|account-read|computer|computer-read|browser|browser-read|document)\";q=600|\"(source|comment-live|comment-write)\";q=60|\"comment-board\";q=300);w=60$","examples":["\"account\";q=600;w=60","\"computer-read\";q=600;w=60"]}},"Retry-After":{"description":"Whole seconds to wait after an api_request_rate_exceeded, comment_rate_exceeded, comment_site_rate_exceeded, comment_live_full or computer_starting response before retrying (up to 3600 for comment_site_rate_exceeded, whose window is an hour). Other 429 problem codes describe separate resource or provider limits and do not inherit this retry value.","schema":{"type":"integer","minimum":1,"maximum":3600,"examples":[42]}}},"description":"Too Many Requests. `comment_rate_exceeded`: anyone but the owner and the people the computer is shared with may make 10 comments, replies and retractions a minute on one computer; wait for Retry-After seconds and send it again, nothing was saved. `comment_site_rate_exceeded`: anyone but the owner and the people the computer is shared with may create 60 comments an hour on one computer, all together; wait for Retry-After seconds and send it again, nothing was saved. `api_request_rate_exceeded`: the account request limit; wait for Retry-After seconds.","content":{"application/problem+json":{"schema":{"type":"object","additionalProperties":false,"required":["type","title","status","code","detail"],"properties":{"type":{"type":"string","format":"uri","description":"https://cool.computer/docs/api-reference/errors, the page that explains every code.","isRequired":true,"uniqueKey":"type","typeLabel":"string\u003curi>"},"title":{"type":"string","isRequired":true,"uniqueKey":"title","typeLabel":"string"},"status":{"type":"integer","minimum":400,"maximum":599,"isRequired":true,"uniqueKey":"status","typeLabel":"integer"},"code":{"type":"string","pattern":"^[a-z0-9_]+$","isRequired":true,"uniqueKey":"code","typeLabel":"string"},"detail":{"type":"string","isRequired":true,"uniqueKey":"detail","typeLabel":"string"},"resolution":{"type":"string","uniqueKey":"resolution","typeLabel":"string"},"context":{"type":"object","additionalProperties":true,"uniqueKey":"context","typeLabel":"object"},"suggestions":{"type":"array","items":{"type":"string","uniqueKey":"suggestions.items.[INDEX]","typeLabel":"string"},"maxItems":3,"description":"Values to send instead. With name_taken: up to three free names made from the requested one, the first with a random suffix; each was free when the answer was made.","uniqueKey":"suggestions","typeLabel":"string[]"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"type":"\u003cstring>","title":"\u003cstring>","status":499,"code":"\u003cstring>","detail":"\u003cstring>","resolution":"\u003cstring>","context":{},"suggestions":["\u003cstring>"]}}},"exampleType":"generated"}},"exampleType":"generated"},"4aec46df-cba8-4b9a-ba48-c3f7bf127b87":{"headers":{"RateLimit":{"description":"The applied policy name, requests remaining after this request, and whole seconds until the current UTC-aligned window resets.","schema":{"type":"string","pattern":"^\"(account|account-read|computer|computer-read|browser|browser-read|document|source|comment-board|comment-live|comment-write)\";r=[0-9]+;t=([1-9]|[1-5][0-9]|60)$","examples":["\"account\";r=599;t=42","\"computer-read\";r=598;t=42"]}},"RateLimit-Policy":{"description":"The selected policy name, quota, and window in seconds. Valid account credentials use account or account-read with q=600, computer credentials use computer or computer-read with q=600, a browser session uses browser or browser-read with q=600 on the website's same-origin requests and document with q=600 on document routes, unauthenticated or unrecognized requests use source with q=60 for their source IP, a request without an Authorization header reading a comment board uses comment-board with q=300 for its source IP, writing to comments (the comment layer's writes and steps) uses comment-write with q=60 for its source IP, and a browser session's handshake of a comment live channel uses comment-live with q=60 for its source IP.","schema":{"type":"string","pattern":"^(\"(account|account-read|computer|computer-read|browser|browser-read|document)\";q=600|\"(source|comment-live|comment-write)\";q=60|\"comment-board\";q=300);w=60$","examples":["\"account\";q=600;w=60","\"computer-read\";q=600;w=60"]}}},"description":"Internal Server Error.","content":{"application/problem+json":{"schema":{"type":"object","additionalProperties":false,"required":["type","title","status","code","detail"],"properties":{"type":{"type":"string","format":"uri","description":"https://cool.computer/docs/api-reference/errors, the page that explains every code.","isRequired":true,"uniqueKey":"type","typeLabel":"string\u003curi>"},"title":{"type":"string","isRequired":true,"uniqueKey":"title","typeLabel":"string"},"status":{"type":"integer","minimum":400,"maximum":599,"isRequired":true,"uniqueKey":"status","typeLabel":"integer"},"code":{"type":"string","pattern":"^[a-z0-9_]+$","isRequired":true,"uniqueKey":"code","typeLabel":"string"},"detail":{"type":"string","isRequired":true,"uniqueKey":"detail","typeLabel":"string"},"resolution":{"type":"string","uniqueKey":"resolution","typeLabel":"string"},"context":{"type":"object","additionalProperties":true,"uniqueKey":"context","typeLabel":"object"},"suggestions":{"type":"array","items":{"type":"string","uniqueKey":"suggestions.items.[INDEX]","typeLabel":"string"},"maxItems":3,"description":"Values to send instead. With name_taken: up to three free names made from the requested one, the first with a random suffix; each was free when the answer was made.","uniqueKey":"suggestions","typeLabel":"string[]"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"type":"\u003cstring>","title":"\u003cstring>","status":499,"code":"\u003cstring>","detail":"\u003cstring>","resolution":"\u003cstring>","context":{},"suggestions":["\u003cstring>"]}}},"exampleType":"generated"}},"exampleType":"generated"},"52a14487-ec0f-4d66-93a5-865e7da3567a":{"headers":{"RateLimit":{"description":"The applied policy name, requests remaining after this request, and whole seconds until the current UTC-aligned window resets.","schema":{"type":"string","pattern":"^\"(account|account-read|computer|computer-read|browser|browser-read|document|source|comment-board|comment-live|comment-write)\";r=[0-9]+;t=([1-9]|[1-5][0-9]|60)$","examples":["\"account\";r=599;t=42","\"computer-read\";r=598;t=42"]}},"RateLimit-Policy":{"description":"The selected policy name, quota, and window in seconds. Valid account credentials use account or account-read with q=600, computer credentials use computer or computer-read with q=600, a browser session uses browser or browser-read with q=600 on the website's same-origin requests and document with q=600 on document routes, unauthenticated or unrecognized requests use source with q=60 for their source IP, a request without an Authorization header reading a comment board uses comment-board with q=300 for its source IP, writing to comments (the comment layer's writes and steps) uses comment-write with q=60 for its source IP, and a browser session's handshake of a comment live channel uses comment-live with q=60 for its source IP.","schema":{"type":"string","pattern":"^(\"(account|account-read|computer|computer-read|browser|browser-read|document)\";q=600|\"(source|comment-live|comment-write)\";q=60|\"comment-board\";q=300);w=60$","examples":["\"account\";q=600;w=60","\"computer-read\";q=600;w=60"]}}},"description":"A machine-readable API error with a stable code and recovery instruction.","content":{"application/problem+json":{"schema":{"type":"object","additionalProperties":false,"required":["type","title","status","code","detail"],"properties":{"type":{"type":"string","format":"uri","description":"https://cool.computer/docs/api-reference/errors, the page that explains every code.","isRequired":true,"uniqueKey":"type","typeLabel":"string\u003curi>"},"title":{"type":"string","isRequired":true,"uniqueKey":"title","typeLabel":"string"},"status":{"type":"integer","minimum":400,"maximum":599,"isRequired":true,"uniqueKey":"status","typeLabel":"integer"},"code":{"type":"string","pattern":"^[a-z0-9_]+$","isRequired":true,"uniqueKey":"code","typeLabel":"string"},"detail":{"type":"string","isRequired":true,"uniqueKey":"detail","typeLabel":"string"},"resolution":{"type":"string","uniqueKey":"resolution","typeLabel":"string"},"context":{"type":"object","additionalProperties":true,"uniqueKey":"context","typeLabel":"object"},"suggestions":{"type":"array","items":{"type":"string","uniqueKey":"suggestions.items.[INDEX]","typeLabel":"string"},"maxItems":3,"description":"Values to send instead. With name_taken: up to three free names made from the requested one, the first with a random suffix; each was free when the answer was made.","uniqueKey":"suggestions","typeLabel":"string[]"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"type":"\u003cstring>","title":"\u003cstring>","status":499,"code":"\u003cstring>","detail":"\u003cstring>","resolution":"\u003cstring>","context":{},"suggestions":["\u003cstring>"]}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"15db37d7-9534-454c-9ee9-175b03f095b9":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"WorkOS user or agent access token, or Cool Computers API key","description":"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.","scopes":[],"schemeName":"bearerAuth"}}},"servers":{"87260cfd-6eb9-4cfd-9719-f9d5b3e89d18":{"url":"https://api.cool.computer","description":"Canonical API origin"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","bearerFormat":"WorkOS user or agent access token, or Cool Computers API key","description":"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.","scopes":[],"schemeName":"bearerAuth"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"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.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"bearerAuth","name":"Authorization"}],"title":"bearerAuth"}]},"originalFileLocation":"https://www.cool.computer/openapi.json"},"subdomain":"cool-computer","siteName":"Cool Computers","title":"Create computer comment - Cool Computers","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-12T02:03:06.573Z","originalFileLocation":"api-reference/comments/create-computer-comment.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Also accepts this computer\u0026#x27;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\u0026#x27;s own unanswered comments only; pull, resolve, reopen and deleting others\u0026#x27; 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\u0026#x27;s own sign-in, not an organization API key). Leaves a comment on a page of the computer\u0026#x27;s site, anchored to an element or an area. Text is cleaned and must be 1 byte up to the text\u0026#x27;s maxLength in CreateCommentRequest, and may be empty for a drawing. The owner\u0026#x27;s agents read it with the pull; the owner hands it to Operator with POST /api/computers/{id}/comments/ask. An agent with the owner\u0026#x27;s credential leaves a comment the same way (the MCP tool cool_leave_comment), naming itself in agent so the comment is the agent\u0026#x27;s, not the owner\u0026#x27;s: an element anchor with only page and selector, rect left out, or a drawing: an area anchor with page and ink.marks, each mark an element\u0026#x27;s el and one of a path in that element\u0026#x27;s own box, a named shape or words to write (see CommentInk), selector and rect left out, or a part of the page: an area anchor with page and rect (the tool\u0026#x27;s area), selector and ink left out. A computer holds any number of comments. Anyone but the owner and the people the computer is shared with may make 10 writes a minute on one computer, and together 60 new comments an hour.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Cool Computers\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/docs/mintlify-assets/_mintlify/favicons/cool-computer/xIPLAHBDS_7J4vCp/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/docs/mintlify-assets/_mintlify/favicons/cool-computer/xIPLAHBDS_7J4vCp/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/docs/mintlify-assets/_mintlify/favicons/cool-computer/xIPLAHBDS_7J4vCp/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/docs/mintlify-assets/_mintlify/favicons/cool-computer/xIPLAHBDS_7J4vCp/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/docs/mintlify-assets/_mintlify/favicons/cool-computer/xIPLAHBDS_7J4vCp/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/docs/mintlify-assets/_mintlify/favicons/cool-computer/xIPLAHBDS_7J4vCp/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/docs/mintlify-assets/_mintlify/favicons/cool-computer/xIPLAHBDS_7J4vCp/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/docs/mintlify-assets/_mintlify/favicons/cool-computer/xIPLAHBDS_7J4vCp/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/docs/mintlify-assets/_mintlify/favicons/cool-computer/xIPLAHBDS_7J4vCp/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Create computer comment - Cool Computers\">\u003cmeta data-mint-head property=\"og:description\" content=\"Also accepts this computer\u0026#x27;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\u0026#x27;s own unanswered comments only; pull, resolve, reopen and deleting others\u0026#x27; 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\u0026#x27;s own sign-in, not an organization API key). Leaves a comment on a page of the computer\u0026#x27;s site, anchored to an element or an area. Text is cleaned and must be 1 byte up to the text\u0026#x27;s maxLength in CreateCommentRequest, and may be empty for a drawing. The owner\u0026#x27;s agents read it with the pull; the owner hands it to Operator with POST /api/computers/{id}/comments/ask. An agent with the owner\u0026#x27;s credential leaves a comment the same way (the MCP tool cool_leave_comment), naming itself in agent so the comment is the agent\u0026#x27;s, not the owner\u0026#x27;s: an element anchor with only page and selector, rect left out, or a drawing: an area anchor with page and ink.marks, each mark an element\u0026#x27;s el and one of a path in that element\u0026#x27;s own box, a named shape or words to write (see CommentInk), selector and rect left out, or a part of the page: an area anchor with page and rect (the tool\u0026#x27;s area), selector and ink left out. A computer holds any number of comments. Anyone but the owner and the people the computer is shared with may make 10 writes a minute on one computer, and together 60 new comments an hour.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Cool Computers\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://cool.computer/docs/api-reference/comments/create-computer-comment\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://cool-computer.mintlify.site/docs/_mintlify/api/og/v2?division=Comments\u0026amp;title=Create+computer+comment\u0026amp;description=Also+accepts+this+computer%27s+own+runtime+token%2C+with+the+computer+named+by+its+name+or+id%3B+a+different+computer+returns+404.+Sharing+is+checked+per+request+usin\u0026amp;theme=858c3a650bdc869e23698759\u0026amp;signature=c273a24432d67abc29f1cefb5402945700d44159fe2a29dab7ab7ac72db6e7a6\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Create computer comment - Cool Computers\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Also accepts this computer\u0026#x27;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\u0026#x27;s own unanswered comments only; pull, resolve, reopen and deleting others\u0026#x27; 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\u0026#x27;s own sign-in, not an organization API key). Leaves a comment on a page of the computer\u0026#x27;s site, anchored to an element or an area. Text is cleaned and must be 1 byte up to the text\u0026#x27;s maxLength in CreateCommentRequest, and may be empty for a drawing. The owner\u0026#x27;s agents read it with the pull; the owner hands it to Operator with POST /api/computers/{id}/comments/ask. An agent with the owner\u0026#x27;s credential leaves a comment the same way (the MCP tool cool_leave_comment), naming itself in agent so the comment is the agent\u0026#x27;s, not the owner\u0026#x27;s: an element anchor with only page and selector, rect left out, or a drawing: an area anchor with page and ink.marks, each mark an element\u0026#x27;s el and one of a path in that element\u0026#x27;s own box, a named shape or words to write (see CommentInk), selector and rect left out, or a part of the page: an area anchor with page and rect (the tool\u0026#x27;s area), selector and ink left out. A computer holds any number of comments. Anyone but the owner and the people the computer is shared with may make 10 writes a minute on one computer, and together 60 new comments an hour.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://cool-computer.mintlify.site/docs/_mintlify/api/og/v2?division=Comments\u0026amp;title=Create+computer+comment\u0026amp;description=Also+accepts+this+computer%27s+own+runtime+token%2C+with+the+computer+named+by+its+name+or+id%3B+a+different+computer+returns+404.+Sharing+is+checked+per+request+usin\u0026amp;theme=858c3a650bdc869e23698759\u0026amp;signature=c273a24432d67abc29f1cefb5402945700d44159fe2a29dab7ab7ac72db6e7a6\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/docs/mintlify-assets/_mintlify/favicons/cool-computer/xIPLAHBDS_7J4vCp/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Cool Computers\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#155DFF\">\u003clink data-mint-head rel=\"canonical\" href=\"https://cool.computer/docs/api-reference/comments/create-computer-comment\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/docs/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/docs/api-reference/comments/create-computer-comment.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://cool.computer/#organization\",\"name\":\"Cool Computers\",\"url\":\"https://cool.computer\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/cool-computer/gsKImuLFY1EhcYOS/logo-light.png?fit=max\u0026auto=format\u0026n=gsKImuLFY1EhcYOS\u0026q=85\u0026s=7ce85c74fc810b3de8ef57e45d050e55\"}},{\"@type\":\"WebSite\",\"@id\":\"https://cool.computer/docs#website\",\"name\":\"Cool Computers\",\"url\":\"https://cool.computer/docs\",\"publisher\":{\"@id\":\"https://cool.computer/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://cool.computer/docs/api-reference/comments/create-computer-comment#webpage\",\"url\":\"https://cool.computer/docs/api-reference/comments/create-computer-comment\",\"name\":\"Create computer comment\",\"description\":\"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). Leaves a comment on a page of the computer's site, anchored to an element or an area. Text is cleaned and must be 1 byte up to the text's maxLength in CreateCommentRequest, and may be empty for a drawing. The owner's agents read it with the pull; the owner hands it to Operator with POST /api/computers/{id}/comments/ask. An agent with the owner's credential leaves a comment the same way (the MCP tool cool_leave_comment), naming itself in agent so the comment is the agent's, not the owner's: an element anchor with only page and selector, rect left out, or a drawing: an area anchor with page and ink.marks, each mark an element's el and one of a path in that element's own box, a named shape or words to write (see CommentInk), selector and rect left out, or a part of the page: an area anchor with page and rect (the tool's area), selector and ink left out. A computer holds any number of comments. Anyone but the owner and the people the computer is shared with may make 10 writes a minute on one computer, and together 60 new comments an hour.\",\"dateModified\":\"2026-11-12T02:03:06.573Z\",\"isPartOf\":{\"@id\":\"https://cool.computer/docs#website\"},\"breadcrumb\":{\"@id\":\"https://cool.computer/docs/api-reference/comments/create-computer-comment#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://cool.computer/docs/api-reference/comments/create-computer-comment#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Endpoint reference\",\"item\":\"https://cool.computer/docs/api-reference/integrations/list-integrations\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Comments\",\"item\":\"https://cool.computer/docs/api-reference/comments/pull-computer-comments\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Create computer comment\",\"item\":\"https://cool.computer/docs/api-reference/comments/create-computer-comment\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://cool.computer/docs/api-reference/comments/create-computer-comment#apireference\",\"headline\":\"Create computer comment\",\"name\":\"Create computer comment\",\"description\":\"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). Leaves a comment on a page of the computer's site, anchored to an element or an area. Text is cleaned and must be 1 byte up to the text's maxLength in CreateCommentRequest, and may be empty for a drawing. The owner's agents read it with the pull; the owner hands it to Operator with POST /api/computers/{id}/comments/ask. An agent with the owner's credential leaves a comment the same way (the MCP tool cool_leave_comment), naming itself in agent so the comment is the agent's, not the owner's: an element anchor with only page and selector, rect left out, or a drawing: an area anchor with page and ink.marks, each mark an element's el and one of a path in that element's own box, a named shape or words to write (see CommentInk), selector and rect left out, or a part of the page: an area anchor with page and rect (the tool's area), selector and ink left out. A computer holds any number of comments. Anyone but the owner and the people the computer is shared with may make 10 writes a minute on one computer, and together 60 new comments an hour.\",\"url\":\"https://cool.computer/docs/api-reference/comments/create-computer-comment\",\"mainEntityOfPage\":{\"@id\":\"https://cool.computer/docs/api-reference/comments/create-computer-comment#webpage\"},\"dateModified\":\"2026-11-12T02:03:06.573Z\",\"publisher\":{\"@id\":\"https://cool.computer/#organization\"},\"isPartOf\":{\"@id\":\"https://cool.computer/docs#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Cool Computers\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Cool Computers\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/docs/api-reference/comments/create-computer-comment.md","siteName":"Cool Computers","nav":{"global":{"anchors":[{"anchor":"Cool Computers","icon":"globe","color":{"light":"#155DFF","dark":"#6AA0FF"},"href":"https://www.cool.computer"}]},"pages":[{"group":"Start here","pages":[{"title":"Cool Computers guide","sidebarTitle":"Introduction","href":"/index"},{"title":"Put your first page online","sidebarTitle":"Quickstart","href":"/getting-started/quickstart"}]},{"group":"Connect your agent","pages":[{"title":"Connect your agent to Cool Computers","sidebarTitle":"Overview","icon":"plug","href":"/agents/overview"},{"title":"Use Cool Computers with Claude Code","sidebarTitle":"Claude Code","icon":"https://mintlify.s3.us-west-1.amazonaws.com/cool-computer/images/agents/claude.svg","href":"/agents/claude-code"},{"title":"Use Cool Computers with Codex","sidebarTitle":"Codex","icon":"https://mintlify.s3.us-west-1.amazonaws.com/cool-computer/images/agents/openai.svg","href":"/agents/codex"},{"title":"Use Cool Computers with Cursor","sidebarTitle":"Cursor","icon":"https://mintlify.s3.us-west-1.amazonaws.com/cool-computer/images/agents/cursor.svg","href":"/agents/cursor"},{"title":"Use Cool Computers with Pi","sidebarTitle":"Pi","icon":"https://mintlify.s3.us-west-1.amazonaws.com/cool-computer/images/agents/pi.svg","href":"/agents/pi"},{"title":"Use Cool Computers with Gemini CLI","sidebarTitle":"Gemini CLI","icon":"https://mintlify.s3.us-west-1.amazonaws.com/cool-computer/images/agents/gemini.svg","href":"/agents/gemini"},{"title":"Use Cool Computers with Hermes Agent","sidebarTitle":"Hermes Agent","icon":"https://mintlify.s3.us-west-1.amazonaws.com/cool-computer/images/agents/hermes.svg","href":"/agents/hermes"},{"title":"Use Cool Computers with OpenClaw","sidebarTitle":"OpenClaw","icon":"https://mintlify.s3.us-west-1.amazonaws.com/cool-computer/images/agents/openclaw.svg","href":"/agents/openclaw"},{"title":"Use Cool Computers with Claude","sidebarTitle":"Claude","icon":"https://mintlify.s3.us-west-1.amazonaws.com/cool-computer/images/agents/claude.svg","href":"/agents/claude"},{"title":"Use Cool Computers with ChatGPT","sidebarTitle":"ChatGPT","icon":"https://mintlify.s3.us-west-1.amazonaws.com/cool-computer/images/agents/openai.svg","href":"/agents/chatgpt"},{"title":"Use Cool Computers with Grok","sidebarTitle":"Grok","icon":"https://mintlify.s3.us-west-1.amazonaws.com/cool-computer/images/agents/grok.svg","href":"/agents/grok"},{"title":"Use Cool Computers with other MCP clients","sidebarTitle":"Other MCP clients","icon":"blocks","href":"/agents/other-mcp-clients"},{"title":"Install the Cool Computers CLI","sidebarTitle":"Install the CLI","icon":"terminal","href":"/agents/cli"},{"title":"Open Cool Computers with SSH","sidebarTitle":"SSH","icon":"key","href":"/agents/ssh"}]},{"group":"Your computer","pages":[{"title":"How a computer works","href":"/computers/how-it-works"},{"title":"What persists","href":"/computers/persistence"}]},{"group":"Use it","pages":[{"title":"Cool Computers CLI","sidebarTitle":"Use the CLI","href":"/use/cli"},{"title":"Email your computer","sidebarTitle":"Email a task","href":"/use/email"}]},{"group":"Build with the API","pages":[{"title":"Cool Computers HTTP API","sidebarTitle":"API overview","href":"/api-reference/overview"},{"title":"Cool Computers API authentication","sidebarTitle":"Authentication","href":"/api-reference/authentication"},{"title":"API errors","href":"/api-reference/errors"}]},{"group":"Endpoint reference","pages":[{"group":"Integrations","pages":[{"title":"List integrations","deprecated":null,"version":null,"openapi":"https://www.cool.computer/openapi.json get /api/integrations","href":"/api-reference/integrations/list-integrations"},{"title":"Verify integration","deprecated":null,"version":null,"openapi":"https://www.cool.computer/openapi.json post /api/integrations/{name}/verify","href":"/api-reference/integrations/verify-integration"},{"title":"Start integration connection","deprecated":null,"version":null,"openapi":"https://www.cool.computer/openapi.json post /api/integrations/connect","href":"/api-reference/integrations/start-integration-connection"},{"title":"Inspect integration connection","deprecated":null,"version":null,"openapi":"https://www.cool.computer/openapi.json get /api/integrations/connect/{id}","href":"/api-reference/integrations/inspect-integration-connection"},{"title":"Cancel integration connection","deprecated":null,"version":null,"openapi":"https://www.cool.computer/openapi.json delete /api/integrations/connect/{id}","href":"/api-reference/integrations/cancel-integration-connection"},{"title":"Submit integration authorization code","deprecated":null,"version":null,"openapi":"https://www.cool.computer/openapi.json post /api/integrations/connect/{id}/code","href":"/api-reference/integrations/submit-integration-authorization-code"},{"title":"Disconnect integration","deprecated":null,"version":null,"openapi":"https://www.cool.computer/openapi.json delete /api/integrations/{name}","href":"/api-reference/integrations/disconnect-integration"},{"title":"Discover computer integrations","deprecated":null,"version":null,"openapi":"https://www.cool.computer/openapi.json get /api/computers/{id}/integrations","href":"/api-reference/integrations/discover-computer-integrations"},{"title":"Verify Claude on a computer","deprecated":null,"version":null,"openapi":"https://www.cool.computer/openapi.json post /api/computers/{id}/provider-credentials/claude/verify","href":"/api-reference/integrations/verify-claude-on-a-computer"}]},{"group":"Secrets","pages":[{"title":"Read a secret set's values on a computer","deprecated":null,"version":null,"openapi":"https://www.cool.computer/openapi.json post /api/computers/{id}/secrets/{secret_set}/session","href":"/api-reference/secrets/read-a-secret-sets-values-on-a-computer"},{"title":"List secret sets","deprecated":null,"version":null,"openapi":"https://www.cool.computer/openapi.json get /api/secrets","href":"/api-reference/secrets/list-secret-sets"},{"title":"List secret audit history","deprecated":null,"version":null,"openapi":"https://www.cool.computer/openapi.json get /api/secrets/audit","href":"/api-reference/secrets/list-secret-audit-history"},{"title":"Inspect a secret set","deprecated":null,"version":null,"openapi":"https://www.cool.computer/openapi.json get /api/secrets/{secret_set}","href":"/api-reference/secrets/inspect-a-secret-set"},{"title":"Create or replace a secret set","deprecated":null,"version":null,"openapi":"https://www.cool.computer/openapi.json put /api/secrets/{secret_set}","href":"/api-reference/secrets/create-or-replace-a-secret-set"},{"title":"Delete a secret set","deprecated":null,"version":null,"openapi":"https://www.cool.computer/openapi.json delete /api/secrets/{secret_set}","href":"/api-reference/secrets/delete-a-secret-set"},{"title":"List a computer's secret sets","deprecated":null,"version":null,"openapi":"https://www.cool.computer/openapi.json get /api/computers/{id}/secrets","href":"/api-reference/secrets/list-a-computers-secret-sets"},{"title":"Inspect a computer's secret set","deprecated":null,"version":null,"openapi":"https://www.cool.computer/openapi.json get /api/computers/{id}/secrets/{secret_set}","href":"/api-reference/secrets/inspect-a-computers-secret-set"}]},{"group":"Authentication","pages":[{"title":"Revoke an SSH key","deprecated":null,"version":null,"openapi":"https://www.cool.computer/openapi.json delete /api/ssh-keys/{id}","href":"/api-reference/authentication/revoke-an-ssh-key"},{"title":"Send an authentication code","deprecated":null,"version":null,"openapi":"https://www.cool.computer/openapi.json post /api/auth/email/start","href":"/api-reference/authentication/send-an-authentication-code"},{"title":"Exchange an email code","deprecated":null,"version":null,"openapi":"https://www.cool.computer/openapi.json post /api/auth/email/complete","href":"/api-reference/authentication/exchange-an-email-code"},{"title":"Whether sign-up is open","deprecated":null,"version":null,"openapi":"https://www.cool.computer/openapi.json get /api/signup","href":"/api-reference/authentication/whether-sign-up-is-open"},{"title":"Join the waitlist","deprecated":null,"version":null,"openapi":"https://www.cool.computer/openapi.json post /api/waitlist","href":"/api-reference/authentication/join-the-waitlist"},{"title":"Refresh an authentication session","deprecated":null,"version":null,"openapi":"https://www.cool.computer/openapi.json post /api/auth/refresh","href":"/api-reference/authentication/refresh-an-authentication-session"},{"title":"Open the website as the CLI session","deprecated":null,"version":null,"openapi":"https://www.cool.computer/openapi.json post /api/auth/browser-handoff","href":"/api-reference/authentication/open-the-website-as-the-cli-session"},{"title":"Inspect the current account","deprecated":null,"version":null,"openapi":"https://www.cool.computer/openapi.json get /api/auth/whoami","href":"/api-reference/authentication/inspect-the-current-account"},{"title":"Revoke the current credential","deprecated":null,"version":null,"openapi":"https://www.cool.computer/openapi.json post /api/auth/logout","href":"/api-reference/authentication/revoke-the-current-credential"},{"title":"Change the owner's display name","deprecated":null,"version":null,"openapi":"https://www.cool.computer/openapi.json patch /api/account","href":"/api-reference/authentication/change-the-owners-display-name"},{"title":"List API keys","deprecated":null,"version":null,"openapi":"https://www.cool.computer/openapi.json get /api/api-keys","href":"/api-reference/authentication/list-api-keys"},{"title":"Create an API key","deprecated":null,"version":null,"openapi":"https://www.cool.computer/openapi.json post /api/api-keys","href":"/api-reference/authentication/create-an-api-key"},{"title":"Revoke an API key","deprecated":null,"version":null,"openapi":"https://www.cool.computer/openapi.json delete /api/api-keys/{id}","href":"/api-reference/authentication/revoke-an-api-key"},{"title":"List SSH keys","deprecated":null,"version":null,"openapi":"https://www.cool.computer/openapi.json get /api/ssh-keys","href":"/api-reference/authentication/list-ssh-keys"}]},{"group":"Services","pages":[{"title":"Stop a service","deprecated":null,"version":null,"openapi":"https://www.cool.computer/openapi.json post /api/computers/{id}/service/stop","href":"/api-reference/services/stop-a-service"},{"title":"Read HTTP exposure","deprecated":null,"version":null,"openapi":"https://www.cool.computer/openapi.json get /api/computers/{id}/exposure","href":"/api-reference/services/read-http-exposure"},{"title":"Expose an HTTP port","deprecated":null,"version":null,"openapi":"https://www.cool.computer/openapi.json put /api/computers/{id}/exposure","href":"/api-reference/services/expose-an-http-port"},{"title":"Remove HTTP exposure","deprecated":null,"version":null,"openapi":"https://www.cool.computer/openapi.json delete /api/computers/{id}/exposure","href":"/api-reference/services/remove-http-exposure"},{"title":"Inspect the managed service","deprecated":null,"version":null,"openapi":"https://www.cool.computer/openapi.json get /api/computers/{id}/service","href":"/api-reference/services/inspect-the-managed-service"},{"title":"Clear a service","deprecated":null,"version":null,"openapi":"https://www.cool.computer/openapi.json delete /api/computers/{id}/service","href":"/api-reference/services/clear-a-service"},{"title":"Run the computer's service","deprecated":null,"version":null,"openapi":"https://www.cool.computer/openapi.json post /api/computers/{id}/service/run","href":"/api-reference/services/run-the-computers-service"},{"title":"Restart a published service","deprecated":null,"version":null,"openapi":"https://www.cool.computer/openapi.json post /api/computers/{id}/service/restart","href":"/api-reference/services/restart-a-published-service"},{"title":"Read service logs","deprecated":null,"version":null,"openapi":"https://www.cool.computer/openapi.json get /api/computers/{id}/service/logs","href":"/api-reference/services/read-service-logs"}]},{"group":"Execution","pages":[{"title":"Run a command and stream its output","deprecated":null,"version":null,"openapi":"https://www.cool.computer/openapi.json post /api/computers/{id}/exec/stream","href":"/api-reference/execution/run-a-command-and-stream-its-output"},{"title":"Run a command","deprecated":null,"version":null,"openapi":"https://www.cool.computer/openapi.json post /api/computers/{id}/exec","href":"/api-reference/execution/run-a-command"},{"title":"Attach to an existing command","deprecated":null,"version":null,"openapi":"https://www.cool.computer/openapi.json post /api/computers/{id}/exec/attach","href":"/api-reference/execution/attach-to-an-existing-command"},{"title":"Cancel a command","deprecated":null,"version":null,"openapi":"https://www.cool.computer/openapi.json post /api/computers/{id}/exec/cancel","href":"/api-reference/execution/cancel-a-command"}]},{"group":"Terminals","pages":[{"title":"Reconnect to a terminal","deprecated":null,"version":null,"openapi":"https://www.cool.computer/openapi.json post /api/computers/{id}/terminals/{pty_id}/ticket","href":"/api-reference/terminals/reconnect-to-a-terminal"},{"title":"Close a terminal","deprecated":null,"version":null,"openapi":"https://www.cool.computer/openapi.json delete /api/computers/{id}/terminals/{pty_id}","href":"/api-reference/terminals/close-a-terminal"},{"title":"Open a port proxy","deprecated":null,"version":null,"openapi":"https://www.cool.computer/openapi.json post /api/computers/{id}/proxy-ticket","href":"/api-reference/terminals/open-a-port-proxy"},{"title":"List terminals","deprecated":null,"version":null,"openapi":"https://www.cool.computer/openapi.json get /api/computers/{id}/terminals","href":"/api-reference/terminals/list-terminals"},{"title":"Open a terminal","deprecated":null,"version":null,"openapi":"https://www.cool.computer/openapi.json post /api/computers/{id}/terminals","href":"/api-reference/terminals/open-a-terminal"}]},{"group":"Computers","pages":[{"title":"Fetch a page with a browser","deprecated":null,"version":null,"openapi":"https://www.cool.computer/openapi.json post /api/computers/{id}/browser/{action}","href":"/api-reference/computers/fetch-a-page-with-a-browser"},{"title":"Get account usage","deprecated":null,"version":null,"openapi":"https://www.cool.computer/openapi.json get /api/usage","href":"/api-reference/computers/get-account-usage"},{"title":"List computers","deprecated":null,"version":null,"openapi":"https://www.cool.computer/openapi.json get /api/computers","href":"/api-reference/computers/list-computers"},{"title":"Create a computer","deprecated":null,"version":null,"openapi":"https://www.cool.computer/openapi.json post /api/computers","href":"/api-reference/computers/create-a-computer"},{"title":"Get a computer","deprecated":null,"version":null,"openapi":"https://www.cool.computer/openapi.json get /api/computers/{id}","href":"/api-reference/computers/get-a-computer"},{"title":"Delete a computer","deprecated":null,"version":null,"openapi":"https://www.cool.computer/openapi.json delete /api/computers/{id}","href":"/api-reference/computers/delete-a-computer"},{"title":"Give a site its own VM","deprecated":null,"version":null,"openapi":"https://www.cool.computer/openapi.json post /api/computers/{id}/vm","href":"/api-reference/computers/give-a-site-its-own-vm"}]},{"group":"GitHub","pages":[{"title":"Plan a workspace switch","deprecated":null,"version":null,"openapi":"https://www.cool.computer/openapi.json post /api/workspaces/switch/plan","href":"/api-reference/github/plan-a-workspace-switch"},{"title":"Switch to a workspace","deprecated":null,"version":null,"openapi":"https://www.cool.computer/openapi.json post /api/workspaces/switch","href":"/api-reference/github/switch-to-a-workspace"}]},{"group":"Messaging","pages":[{"title":"List messaging channels","deprecated":null,"version":null,"openapi":"https://www.cool.computer/openapi.json get /api/messaging","href":"/api-reference/messaging/list-messaging-channels"},{"title":"Start connecting a messaging channel","deprecated":null,"version":null,"openapi":"https://www.cool.computer/openapi.json post /api/messaging/{provider}/connect","href":"/api-reference/messaging/start-connecting-a-messaging-channel"},{"title":"Disconnect a messaging channel","deprecated":null,"version":null,"openapi":"https://www.cool.computer/openapi.json delete /api/messaging/{provider}","href":"/api-reference/messaging/disconnect-a-messaging-channel"}]},{"group":"Operator","pages":[{"title":"Send an operator message","deprecated":null,"version":null,"openapi":"https://www.cool.computer/openapi.json post /api/operator/conversations/{id}/messages","href":"/api-reference/operator/send-an-operator-message"},{"title":"Cancel an operator turn","deprecated":null,"version":null,"openapi":"https://www.cool.computer/openapi.json post /api/operator/turns/{id}/cancel","href":"/api-reference/operator/cancel-an-operator-turn"},{"title":"Upload an operator attachment","deprecated":null,"version":null,"openapi":"https://www.cool.computer/openapi.json post /api/operator/attachments","href":"/api-reference/operator/upload-an-operator-attachment"},{"title":"Delete an operator attachment","deprecated":null,"version":null,"openapi":"https://www.cool.computer/openapi.json delete /api/operator/attachments/{id}","href":"/api-reference/operator/delete-an-operator-attachment"},{"title":"Download an operator attachment","deprecated":null,"version":null,"openapi":"https://www.cool.computer/openapi.json get /api/operator/attachments/{id}/content","href":"/api-reference/operator/download-an-operator-attachment"},{"title":"List operator conversations","deprecated":null,"version":null,"openapi":"https://www.cool.computer/openapi.json get /api/operator/conversations","href":"/api-reference/operator/list-operator-conversations"},{"title":"Start an operator conversation","deprecated":null,"version":null,"openapi":"https://www.cool.computer/openapi.json post /api/operator/conversations","href":"/api-reference/operator/start-an-operator-conversation"},{"title":"Stream conversation statuses","deprecated":null,"version":null,"openapi":"https://www.cool.computer/openapi.json get /api/operator/conversations/status-events","href":"/api-reference/operator/stream-conversation-statuses"},{"title":"Inspect an operator conversation","deprecated":null,"version":null,"openapi":"https://www.cool.computer/openapi.json get /api/operator/conversations/{id}","href":"/api-reference/operator/inspect-an-operator-conversation"},{"title":"Delete an operator conversation","deprecated":null,"version":null,"openapi":"https://www.cool.computer/openapi.json delete /api/operator/conversations/{id}","href":"/api-reference/operator/delete-an-operator-conversation"},{"title":"Rename an operator conversation","deprecated":null,"version":null,"openapi":"https://www.cool.computer/openapi.json patch /api/operator/conversations/{id}","href":"/api-reference/operator/rename-an-operator-conversation"},{"title":"Page conversation history","deprecated":null,"version":null,"openapi":"https://www.cool.computer/openapi.json get /api/operator/conversations/{id}/history","href":"/api-reference/operator/page-conversation-history"},{"title":"Check access to a conversation's live stream","deprecated":null,"version":null,"openapi":"https://www.cool.computer/openapi.json get /api/operator/conversations/{id}/live-access","href":"/api-reference/operator/check-access-to-a-conversations-live-stream"},{"title":"Inspect an operator turn","deprecated":null,"version":null,"openapi":"https://www.cool.computer/openapi.json get /api/operator/turns/{id}","href":"/api-reference/operator/inspect-an-operator-turn"}]},{"group":"Public","pages":[{"title":"Check API health","deprecated":null,"version":null,"openapi":"https://www.cool.computer/openapi.json get /health","href":"/api-reference/public/check-api-health"}]},{"group":"Billing","pages":[{"title":"Inspect account billing","deprecated":null,"version":null,"openapi":"https://www.cool.computer/openapi.json get /api/billing","href":"/api-reference/billing/inspect-account-billing"},{"title":"List recent invoices","deprecated":null,"version":null,"openapi":"https://www.cool.computer/openapi.json get /api/billing/invoices","href":"/api-reference/billing/list-recent-invoices"},{"title":"Start Pro checkout","deprecated":null,"version":null,"openapi":"https://www.cool.computer/openapi.json post /api/billing/checkout","href":"/api-reference/billing/start-pro-checkout"},{"title":"Manage account billing","deprecated":null,"version":null,"openapi":"https://www.cool.computer/openapi.json post /api/billing/portal","href":"/api-reference/billing/manage-account-billing"}]},{"group":"Network","pages":[{"title":"Set public visibility","deprecated":null,"version":null,"openapi":"https://www.cool.computer/openapi.json put /api/computers/{id}/visibility","href":"/api-reference/network/set-public-visibility"},{"title":"Inspect network settings","deprecated":null,"version":null,"openapi":"https://www.cool.computer/openapi.json get /api/computers/{id}/network","href":"/api-reference/network/inspect-network-settings"},{"title":"Set outbound network access","deprecated":null,"version":null,"openapi":"https://www.cool.computer/openapi.json put /api/computers/{id}/network","href":"/api-reference/network/set-outbound-network-access"},{"title":"Inspect the default network policy","deprecated":null,"version":null,"openapi":"https://www.cool.computer/openapi.json get /api/network/default","href":"/api-reference/network/inspect-the-default-network-policy"},{"title":"Set the default network policy","deprecated":null,"version":null,"openapi":"https://www.cool.computer/openapi.json put /api/network/default","href":"/api-reference/network/set-the-default-network-policy"},{"title":"List outbound denials","deprecated":null,"version":null,"openapi":"https://www.cool.computer/openapi.json get /api/computers/{id}/network/denials","href":"/api-reference/network/list-outbound-denials"}]},{"group":"Sharing","pages":[{"title":"List people you share computers with","deprecated":null,"version":null,"openapi":"https://www.cool.computer/openapi.json get /api/people","href":"/api-reference/sharing/list-people-you-share-computers-with"},{"title":"List people with computer access","deprecated":null,"version":null,"openapi":"https://www.cool.computer/openapi.json get /api/computers/{id}/shares","href":"/api-reference/sharing/list-people-with-computer-access"},{"title":"Invite a computer member","deprecated":null,"version":null,"openapi":"https://www.cool.computer/openapi.json post /api/computers/{id}/shares","href":"/api-reference/sharing/invite-a-computer-member"},{"title":"Stop sharing a computer with a person","deprecated":null,"version":null,"openapi":"https://www.cool.computer/openapi.json delete /api/computers/{id}/shares","href":"/api-reference/sharing/stop-sharing-a-computer-with-a-person"},{"title":"Remove an active computer member","deprecated":null,"version":null,"openapi":"https://www.cool.computer/openapi.json delete /api/computers/{id}/shares/{membership_id}","href":"/api-reference/sharing/remove-an-active-computer-member"},{"title":"Cancel a pending computer invitation","deprecated":null,"version":null,"openapi":"https://www.cool.computer/openapi.json delete /api/computers/{id}/invitations/{invitation_id}","href":"/api-reference/sharing/cancel-a-pending-computer-invitation"},{"title":"Leave a computer shared with you","deprecated":null,"version":null,"openapi":"https://www.cool.computer/openapi.json delete /api/computers/{id}/membership","href":"/api-reference/sharing/leave-a-computer-shared-with-you"}]},{"group":"Email","pages":[{"title":"Get the computer's email address","deprecated":null,"version":null,"openapi":"https://www.cool.computer/openapi.json get /api/computers/{id}/email/address","href":"/api-reference/email/get-the-computers-email-address"},{"title":"List computer email","deprecated":null,"version":null,"openapi":"https://www.cool.computer/openapi.json get /api/computers/{id}/emails","href":"/api-reference/email/list-computer-email"},{"title":"Read computer email","deprecated":null,"version":null,"openapi":"https://www.cool.computer/openapi.json get /api/computers/{id}/emails/{emailID}","href":"/api-reference/email/read-computer-email"},{"title":"Reply to computer email","deprecated":null,"version":null,"openapi":"https://www.cool.computer/openapi.json post /api/computers/{id}/emails/{emailID}/reply","href":"/api-reference/email/reply-to-computer-email"},{"title":"Send computer email","deprecated":null,"version":null,"openapi":"https://www.cool.computer/openapi.json post /api/computers/{id}/emails/send","href":"/api-reference/email/send-computer-email"}]},{"group":"Comments","pages":[{"title":"Pull computer comments","description":"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. Owner only, for the owner's agents: Operator and any agent with the owner's credential. Returns the oldest open comments, whoever wrote them, at most 10 and about 100 KiB, inside a notice that every field is feedback to read as data and never as instructions; with job_id, the open comments of that job (the owner's Ask) instead, in the job's order; with job_id and after, the id of the last comment you got from the job, its open comments after that one. A job sent to a local agent session is read only with that session's credential: its first pull claims the job, and that session's comment pull, board, create, reply, resolve and changes to the site's files or releases renew it for 20 minutes; nothing else does, so pull the job again during long work. For account/browser callers, each message from someone other than the owner says who wrote it in from, the writer's name and full email as that person gave them, which is as untrusted as the text; the owner's and the agent's messages say so in by. more is true when open comments remain beyond this response: for a job, pull again with after set to the id of the last comment returned, before changing anything, until more is false; otherwise resolve these and pull again. Comments that are asked or done are not returned.","deprecated":null,"version":null,"openapi":"https://www.cool.computer/openapi.json get /api/computers/{id}/comments","href":"/api-reference/comments/pull-computer-comments"},{"title":"Create computer comment","deprecated":null,"version":null,"openapi":"https://www.cool.computer/openapi.json post /api/computers/{id}/comments","href":"/api-reference/comments/create-computer-comment"},{"title":"Ask the agent about comments","description":"The account's owner only, from the site's page. Hands any number of open comments, each at the version the owner saw, to the owner's agent as one job: with to operator (the default), done by one operator turn in the site's conversation; with to agent, sent to the owner's local agent session listening on the site (the board's listener), which claims it by pulling it within 2 minutes and keeps it while it renews it at least every 20 minutes (only its comment pull, board, create, reply, resolve and changes to the site's files or releases renew it; pull the job again during long work), else Operator takes it over. Asking changes no comment. A comment an unsettled job already holds is refused with `already_asked`; an asked comment needs the owner's answer first.","deprecated":null,"version":null,"openapi":"https://www.cool.computer/openapi.json post /api/computers/{id}/comments/ask","href":"/api-reference/comments/ask-the-agent-about-comments"},{"title":"Wait for comments sent to your agent","deprecated":null,"version":null,"openapi":"https://www.cool.computer/openapi.json post /api/computers/{id}/comments/watch","href":"/api-reference/comments/wait-for-comments-sent-to-your-agent"},{"title":"Resolve computer comment","deprecated":null,"version":null,"openapi":"https://www.cool.computer/openapi.json post /api/computers/{id}/comments/{commentID}/resolve","href":"/api-reference/comments/resolve-computer-comment"},{"title":"Reopen computer comment","deprecated":null,"version":null,"openapi":"https://www.cool.computer/openapi.json post /api/computers/{id}/comments/{commentID}/reopen","href":"/api-reference/comments/reopen-computer-comment"},{"title":"Get the comment board","deprecated":null,"version":null,"openapi":"https://www.cool.computer/openapi.json get /api/computers/{id}/comments/all","href":"/api-reference/comments/get-the-comment-board"},{"title":"Open the comment live channel","deprecated":null,"version":null,"openapi":"https://www.cool.computer/openapi.json get /api/computers/{id}/comments/live","href":"/api-reference/comments/open-the-comment-live-channel"},{"title":"Record a step of the comment funnel","deprecated":null,"version":null,"openapi":"https://www.cool.computer/openapi.json post /api/computers/{id}/comments/events","href":"/api-reference/comments/record-a-step-of-the-comment-funnel"},{"title":"Reply to a computer comment","deprecated":null,"version":null,"openapi":"https://www.cool.computer/openapi.json post /api/computers/{id}/comments/{commentID}/replies","href":"/api-reference/comments/reply-to-a-computer-comment"},{"title":"Delete computer comment","deprecated":null,"version":null,"openapi":"https://www.cool.computer/openapi.json delete /api/computers/{id}/comments/{commentID}","href":"/api-reference/comments/delete-computer-comment"},{"title":"Get comment settings","deprecated":null,"version":null,"openapi":"https://www.cool.computer/openapi.json get /api/computers/{id}/comment-settings","href":"/api-reference/comments/get-comment-settings"},{"title":"Set comment settings","deprecated":null,"version":null,"openapi":"https://www.cool.computer/openapi.json put /api/computers/{id}/comment-settings","href":"/api-reference/comments/set-comment-settings"}]},{"group":"Publishing","pages":[{"title":"What a copy gets","deprecated":null,"version":null,"openapi":"https://www.cool.computer/openapi.json get /api/computers/{id}/copy","href":"/api-reference/publishing/what-a-copy-gets"},{"title":"Make a copy","deprecated":null,"version":null,"openapi":"https://www.cool.computer/openapi.json post /api/computers/{id}/copy","href":"/api-reference/publishing/make-a-copy"},{"title":"Allow or stop copies","deprecated":null,"version":null,"openapi":"https://www.cool.computer/openapi.json put /api/computers/{id}/copy-settings","href":"/api-reference/publishing/allow-or-stop-copies"},{"title":"Publish files in one request","deprecated":null,"version":null,"openapi":"https://www.cool.computer/openapi.json post /api/publish","href":"/api-reference/publishing/publish-files-in-one-request"},{"title":"Claim a computer published without an account","deprecated":null,"version":null,"openapi":"https://www.cool.computer/openapi.json post /api/computers/{id}/claim","href":"/api-reference/publishing/claim-a-computer-published-without-an-account"},{"title":"Query an owned site's database","deprecated":null,"version":null,"openapi":"https://www.cool.computer/openapi.json post /api/computers/{id}/database/query","href":"/api-reference/publishing/query-an-owned-sites-database"},{"title":"Read an owned site's database","deprecated":null,"version":null,"openapi":"https://www.cool.computer/openapi.json post /api/computers/{id}/database/read","href":"/api-reference/publishing/read-an-owned-sites-database"},{"title":"Read an owned site's function failures","deprecated":null,"version":null,"openapi":"https://www.cool.computer/openapi.json get /api/computers/{id}/logs","href":"/api-reference/publishing/read-an-owned-sites-function-failures"},{"title":"List releases","deprecated":null,"version":null,"openapi":"https://www.cool.computer/openapi.json get /api/computers/{id}/releases","href":"/api-reference/publishing/list-releases"},{"title":"Create a release","deprecated":null,"version":null,"openapi":"https://www.cool.computer/openapi.json post /api/computers/{id}/releases","href":"/api-reference/publishing/create-a-release"},{"title":"Upload release content","deprecated":null,"version":null,"openapi":"https://www.cool.computer/openapi.json put /api/computers/{id}/releases/{number}/blobs/{sha256}","href":"/api-reference/publishing/upload-release-content"},{"title":"Finalize a release","deprecated":null,"version":null,"openapi":"https://www.cool.computer/openapi.json post /api/computers/{id}/releases/{number}/finalize","href":"/api-reference/publishing/finalize-a-release"},{"title":"Make an earlier release live","deprecated":null,"version":null,"openapi":"https://www.cool.computer/openapi.json post /api/computers/{id}/releases/{number}/promote","href":"/api-reference/publishing/make-an-earlier-release-live"}]},{"group":"Domains","pages":[{"title":"Get the computer's custom domain","deprecated":null,"version":null,"openapi":"https://www.cool.computer/openapi.json get /api/computers/{id}/domain","href":"/api-reference/domains/get-the-computers-custom-domain"},{"title":"Connect a custom domain","deprecated":null,"version":null,"openapi":"https://www.cool.computer/openapi.json put /api/computers/{id}/domain","href":"/api-reference/domains/connect-a-custom-domain"},{"title":"Remove the custom domain","deprecated":null,"version":null,"openapi":"https://www.cool.computer/openapi.json delete /api/computers/{id}/domain","href":"/api-reference/domains/remove-the-custom-domain"}]},{"group":"Files","pages":[{"title":"Read document editing access and live version","deprecated":null,"version":null,"openapi":"https://www.cool.computer/openapi.json get /api/computers/{id}/files/document","href":"/api-reference/files/read-document-editing-access-and-live-version"},{"title":"Autosave document files in one release","deprecated":null,"version":null,"openapi":"https://www.cool.computer/openapi.json post /api/computers/{id}/files/document","href":"/api-reference/files/autosave-document-files-in-one-release"},{"title":"List files","deprecated":null,"version":null,"openapi":"https://www.cool.computer/openapi.json get /api/computers/{id}/files/list","href":"/api-reference/files/list-files"},{"title":"Inspect a file","deprecated":null,"version":null,"openapi":"https://www.cool.computer/openapi.json get /api/computers/{id}/files/stat","href":"/api-reference/files/inspect-a-file"},{"title":"Read a file","deprecated":null,"version":null,"openapi":"https://www.cool.computer/openapi.json get /api/computers/{id}/files/read","href":"/api-reference/files/read-a-file"},{"title":"Write a file","deprecated":null,"version":null,"openapi":"https://www.cool.computer/openapi.json put /api/computers/{id}/files/write","href":"/api-reference/files/write-a-file"},{"title":"Create a directory","deprecated":null,"version":null,"openapi":"https://www.cool.computer/openapi.json post /api/computers/{id}/files/mkdir","href":"/api-reference/files/create-a-directory"},{"title":"Upload a file tree","deprecated":null,"version":null,"openapi":"https://www.cool.computer/openapi.json put /api/computers/{id}/files/upload","href":"/api-reference/files/upload-a-file-tree"},{"title":"Download a file tree","deprecated":null,"version":null,"openapi":"https://www.cool.computer/openapi.json get /api/computers/{id}/files/download","href":"/api-reference/files/download-a-file-tree"},{"title":"Delete a file or directory","deprecated":null,"version":null,"openapi":"https://www.cool.computer/openapi.json delete /api/computers/{id}/files/delete","href":"/api-reference/files/delete-a-file-or-directory"}]},{"group":"Feedback","pages":[{"title":"Send feedback","deprecated":null,"version":null,"openapi":"https://www.cool.computer/openapi.json post /api/feedback","href":"/api-reference/feedback/send-feedback"}]}]}]},"basePath":"","title":"Create computer comment - Cool Computers","deploymentId":"dpl_53YqbBPsHdrqSGqXiWPGU7csRVod","buildId":"dpl_53YqbBPsHdrqSGqXiWPGU7csRVod","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-Ku9dSkH0.js","snippetPresets-Cjez4eet.js","utils-BqNa-fnS.js","style-to-object-BY3JEAdk.js","utils-DiE92JCe.js","v4-DIgz8zy6.js","addUniqueKeysToSchema-Bi0DpqVf.js","conditional-requirements-CFM0id0Q.js","cloneDeep-C6xnxscF.js","_Uint8Array-B7g0OYAt.js","isObject-FP1Yky1u.js","ApiExamples-Bf8Ecb5t.js","usePlaygroundInputsStore-BA942cq6.js","shallow-D0sePNkF.js","isEqual-CnnQO8sL.js","CodeSnippets-BTANoy1T.js","CodeSnippet-CTZvgJfu.js","getApiPlaygroundDisplay-BK2o1XYu.js","Page--B9YZ09u.js","DynamicMarkdown-CsgNpZb1.js","SectionHeading-C3K437Dy.js","icon-DlxjjqnB.js","MethodPill-Cr7Ib9nN.js","getPastedJson-DXo3wtHt.js","Check2Icon-ChEI-f_B.js","axios-CsQoIw0U.js","Markdown-CH4mv0N8.js","AssistantPageLink-BHjmqccN.js","dist-DYCPzQwJ.js","lib-DMeTj1gb.js","lib-B8HbPgcC.js","katex-Dbtb6Wk7.js","html-void-elements-mCSPHezU.js","marked.esm-CZWythHk.js"]}