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. Answers one open comment, and returns it as the agent sees it: state done with what changed (on a computer with a VM, listing the files you changed in files), or asked with a question for the owner. Send the version you pulled; if the comment changed, pull again. Resolving the same comment again with the same state and reply returns it unchanged. An answer counts for the comment’s job, whoever gave it. With a browser session, the owner may mark an open or asked comment done; it records the owner as its author and returns a Comment, without a fixed release stamp. Bearer callers retain the agent response.
The computer's name, such as agent-atlas, or its id (cmp_…). Every caller may use either, the computer's own runtime token included.
Minimum string length: 1
Example:
"agent-atlas"
commentID
string
required
Comment identifier returned by the comment board or the pull.
Minimum string length: 1
Example:
"comment_1a2b3c"
Body
application/json
version
integer
required
Required range: x >= 1
state
enum<string>
required
Available options:
done,
asked
reply
string
required
What you changed, or your question, 1 to maxLength bytes.
Required string length: 1 - 1000
files
string[]
The paths of the files you changed, one line each, shown on your answer: with state done only (a question changes nothing, invalid_comment otherwise), and the same list again on a retry. Optional; list them on a computer with a VM, whose files no release records.
Maximum array length: 30
Required string length: 1 - 300
Response
The resolved comment.
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
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.4143","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":"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":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-reference/comments/resolve-computer-comment","slug":"/api-reference/comments/resolve-computer-comment","pageMetadata":{"title":"Resolve 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. Owner only, for the owner's agents: Operator and any agent with the owner's credential. Answers one open comment, and returns it as the agent sees it: state done with what changed (on a computer with a VM, listing the files you changed in files), or asked with a question for the owner. Send the version you pulled; if the comment changed, pull again. Resolving the same comment again with the same state and reply returns it unchanged. An answer counts for the comment's job, whoever gave it. With a browser session, the owner may mark an open or asked comment done; it records the owner as its author and returns a Comment, without a fixed release stamp. Bearer callers retain the agent response.","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","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_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. Owner only, for the owner’s agents: Operator and any agent with the owner’s credential. Answers one open comment, and returns it as the agent sees it: state done with what changed (on a computer with a VM, listing the files you changed in files), or asked with a question for the owner. Send the version you pulled; if the comment changed, pull again. Resolving the same comment again with the same state and reply returns it unchanged. An answer counts for the comment’s job, whoever gave it. With a browser session, the owner may mark an open or asked comment done; it records the owner as its author and returns a Comment, without a fixed release stamp. Bearer callers retain the agent response.\"\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":"Resolve 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. Owner only, for the owner's agents: Operator and any agent with the owner's credential. Answers one open comment, and returns it as the agent sees it: state done with what changed (on a computer with a VM, listing the files you changed in files), or asked with a question for the owner. Send the version you pulled; if the comment changed, pull again. Resolving the same comment again with the same state and reply returns it unchanged. An answer counts for the comment's job, whoever gave it. With a browser session, the owner may mark an open or asked comment done; it records the owner as its author and returns a Comment, without a fixed release stamp. Bearer callers retain the agent response.","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","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"operationId":"resolveComputerComment","summary":"Resolve 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. Owner only, for the owner's agents: Operator and any agent with the owner's credential. Answers one open comment, and returns it as the agent sees it: state done with what changed (on a computer with a VM, listing the files you changed in files), or asked with a question for the owner. Send the version you pulled; if the comment changed, pull again. Resolving the same comment again with the same state and reply returns it unchanged. An answer counts for the comment's job, whoever gave it. With a browser session, the owner may mark an open or asked comment done; it records the owner as its author and returns a Comment, without a fixed release stamp. Bearer callers retain the agent response.","tags":["Comments"],"security":["5933cf36-222e-4153-ab09-2fdf196864d2"],"parameters":["93e64e58-4df3-4067-8333-6b0816e1bd98","e52d531a-8a7c-4301-83f8-5c02779df6c9"],"requestBody":"30aa0c2e-05cd-42ee-9421-f66d9bebfe5c","responses":{"200":"fc4270ab-e987-4472-a147-e14e82cccffd","400":"ed65df16-230e-4157-a720-7606262d20b8","401":"0a30150d-27f3-42ad-8189-533843cd3b2b","404":"ee629153-3ae9-478a-85cc-c638f4fd248d","409":"e8468560-d176-490d-83bd-2fff82ec9605","429":"a34000cd-7a16-4ea9-9279-d07ace813361","500":"530d5ead-faee-42aa-8947-218535e2dc59","default":"f00e42a0-d166-46a2-bb02-fc961e66b54e"},"method":"post","type":"path","servers":["87260cfd-6eb9-4cfd-9719-f9d5b3e89d18"],"path":"/api/computers/{id}/comments/{commentID}/resolve","baseUrlOptions":["https://api.cool.computer"],"title":"Resolve computer comment","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"93e64e58-4df3-4067-8333-6b0816e1bd98":{"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"}},"e52d531a-8a7c-4301-83f8-5c02779df6c9":{"name":"commentID","in":"path","required":true,"description":"Comment identifier returned by the comment board or the pull.","schema":{"type":"string","minLength":1,"example":"comment_1a2b3c","isRequired":true,"description":"Comment identifier returned by the comment board or the pull.","uniqueKey":"","typeLabel":"string"}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["version","state","reply"],"properties":{"version":{"type":"integer","minimum":1,"isRequired":true,"uniqueKey":"version","typeLabel":"integer"},"state":{"type":"string","enum":["done","asked"],"isRequired":true,"uniqueKey":"state","typeLabel":"enum\u003cstring>"},"reply":{"type":"string","minLength":1,"maxLength":1000,"description":"What you changed, or your question, 1 to maxLength bytes.","isRequired":true,"uniqueKey":"reply","typeLabel":"string"},"files":{"type":"array","maxItems":30,"items":{"type":"string","minLength":1,"maxLength":300,"uniqueKey":"files.items.[INDEX]","typeLabel":"string"},"description":"The paths of the files you changed, one line each, shown on your answer: with state done only (a question changes nothing, invalid_comment otherwise), and the same list again on a retry. Optional; list them on a computer with a VM, whose files no release records.","uniqueKey":"files","typeLabel":"string[]"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"version":2,"reply":"\u003cstring>","files":["\u003cstring>"]}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"fc4270ab-e987-4472-a147-e14e82cccffd":{"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 resolved comment.","content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["id","state","version","release","anchor","thread"],"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"],"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>"},"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.0.thread.items.[INDEX].from","typeLabel":"string"},"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[]"}},"uniqueKey":"oneOf.0.thread.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"oneOf.0.thread","typeLabel":"object[]"},"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","created_at","updated_at"],"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"],"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.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>"},"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.1.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.1.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.1.thread.items.[INDEX].resolved","typeLabel":"enum\u003cstring>"},"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[]"},"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.1.thread.items.[INDEX].request","typeLabel":"string"}},"uniqueKey":"oneOf.1.thread.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"oneOf.1.thread","typeLabel":"object[]"},"created_at":{"type":"string","format":"date-time","isRequired":true,"uniqueKey":"oneOf.1.created_at","typeLabel":"string\u003cdate-time>"},"updated_at":{"type":"string","format":"date-time","isRequired":true,"uniqueKey":"oneOf.1.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.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","from":"\u003cstring>","files":["\u003cstring>"]}],"fixed_in_release":123}}},"exampleType":"generated"}},"exampleType":"generated"},"ed65df16-230e-4157-a720-7606262d20b8":{"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_version`: send the version you pulled, 1 or more. `invalid_comment`: resolve with state done or asked and a reply of 1 byte up to its maxLength in ResolveCommentRequest, and files within the bounds of ResolveCommentRequest.files.","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"},"0a30150d-27f3-42ad-8189-533843cd3b2b":{"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"},"ee629153-3ae9-478a-85cc-c638f4fd248d":{"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; turn them on with PUT /api/computers/{id}/comment-settings. `comment_not_found`: pull the open comments 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"},"e8468560-d176-490d-83bd-2fff82ec9605":{"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":"Conflict. `comment_changed`: pull the open comments again and resolve from the version you get.","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"},"a34000cd-7a16-4ea9-9279-d07ace813361":{"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. If the problem code is api_request_rate_exceeded, wait for Retry-After seconds; other problem codes describe a separate limit.","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"},"530d5ead-faee-42aa-8947-218535e2dc59":{"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"},"f00e42a0-d166-46a2-bb02-fc961e66b54e":{"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":{"5933cf36-222e-4153-ab09-2fdf196864d2":{"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":"Resolve computer comment - Cool Computers","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-12T02:03:06.630Z","originalFileLocation":"api-reference/comments/resolve-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. Owner only, for the owner\u0026#x27;s agents: Operator and any agent with the owner\u0026#x27;s credential. Answers one open comment, and returns it as the agent sees it: state done with what changed (on a computer with a VM, listing the files you changed in files), or asked with a question for the owner. Send the version you pulled; if the comment changed, pull again. Resolving the same comment again with the same state and reply returns it unchanged. An answer counts for the comment\u0026#x27;s job, whoever gave it. With a browser session, the owner may mark an open or asked comment done; it records the owner as its author and returns a Comment, without a fixed release stamp. Bearer callers retain the agent response.\">\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=\"Resolve 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. Owner only, for the owner\u0026#x27;s agents: Operator and any agent with the owner\u0026#x27;s credential. Answers one open comment, and returns it as the agent sees it: state done with what changed (on a computer with a VM, listing the files you changed in files), or asked with a question for the owner. Send the version you pulled; if the comment changed, pull again. Resolving the same comment again with the same state and reply returns it unchanged. An answer counts for the comment\u0026#x27;s job, whoever gave it. With a browser session, the owner may mark an open or asked comment done; it records the owner as its author and returns a Comment, without a fixed release stamp. Bearer callers retain the agent response.\">\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/resolve-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=Resolve+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=7a484ce9d6ac8a56e38d7754c52e9b6a3c734d205f7c082d27c5e8f0d4302e2a\">\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=\"Resolve 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. Owner only, for the owner\u0026#x27;s agents: Operator and any agent with the owner\u0026#x27;s credential. Answers one open comment, and returns it as the agent sees it: state done with what changed (on a computer with a VM, listing the files you changed in files), or asked with a question for the owner. Send the version you pulled; if the comment changed, pull again. Resolving the same comment again with the same state and reply returns it unchanged. An answer counts for the comment\u0026#x27;s job, whoever gave it. With a browser session, the owner may mark an open or asked comment done; it records the owner as its author and returns a Comment, without a fixed release stamp. Bearer callers retain the agent response.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://cool-computer.mintlify.site/docs/_mintlify/api/og/v2?division=Comments\u0026amp;title=Resolve+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=7a484ce9d6ac8a56e38d7754c52e9b6a3c734d205f7c082d27c5e8f0d4302e2a\">\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/resolve-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/resolve-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/resolve-computer-comment#webpage\",\"url\":\"https://cool.computer/docs/api-reference/comments/resolve-computer-comment\",\"name\":\"Resolve 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. Owner only, for the owner's agents: Operator and any agent with the owner's credential. Answers one open comment, and returns it as the agent sees it: state done with what changed (on a computer with a VM, listing the files you changed in files), or asked with a question for the owner. Send the version you pulled; if the comment changed, pull again. Resolving the same comment again with the same state and reply returns it unchanged. An answer counts for the comment's job, whoever gave it. With a browser session, the owner may mark an open or asked comment done; it records the owner as its author and returns a Comment, without a fixed release stamp. Bearer callers retain the agent response.\",\"dateModified\":\"2026-11-12T02:03:06.630Z\",\"isPartOf\":{\"@id\":\"https://cool.computer/docs#website\"},\"breadcrumb\":{\"@id\":\"https://cool.computer/docs/api-reference/comments/resolve-computer-comment#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://cool.computer/docs/api-reference/comments/resolve-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\":\"Resolve computer comment\",\"item\":\"https://cool.computer/docs/api-reference/comments/resolve-computer-comment\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://cool.computer/docs/api-reference/comments/resolve-computer-comment#apireference\",\"headline\":\"Resolve computer comment\",\"name\":\"Resolve 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. Owner only, for the owner's agents: Operator and any agent with the owner's credential. Answers one open comment, and returns it as the agent sees it: state done with what changed (on a computer with a VM, listing the files you changed in files), or asked with a question for the owner. Send the version you pulled; if the comment changed, pull again. Resolving the same comment again with the same state and reply returns it unchanged. An answer counts for the comment's job, whoever gave it. With a browser session, the owner may mark an open or asked comment done; it records the owner as its author and returns a Comment, without a fixed release stamp. Bearer callers retain the agent response.\",\"url\":\"https://cool.computer/docs/api-reference/comments/resolve-computer-comment\",\"mainEntityOfPage\":{\"@id\":\"https://cool.computer/docs/api-reference/comments/resolve-computer-comment#webpage\"},\"dateModified\":\"2026-11-12T02:03:06.630Z\",\"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/resolve-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","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","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","description":"The account's owner only, with a person's own credential: a sign-in session (cool login), an API key or a registered agent's token. The computer's own runtime token is 401; an SSH session of cool.computer, or any other credential that is not a person's, is 403 watch_needs_session. Makes your session the site's listener, which the owner's board shows as listener so the owner can send comments to it (POST /api/computers/{id}/comments/ask with to agent), and waits about 25 seconds for such a job. 200 delivers one job's ids and ends the listening; 204 means none came (or the server is restarting): send the same request again at once. The listening lapses a minute after your last request. One sign-in and agent name listen on a site at a time: their watches may run together, and a job goes to one of them within a hold, then to the next watch again if it is still unread 25 seconds later (an answer can be lost); a watch under another agent name or another sign-in is 409 agent_already_listening while it listens. Only a site without a VM takes local jobs. Pull the job with GET /api/computers/{id}/comments?job_id=, which claims it, answer each comment with resolve, then watch again.","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","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. Records the owner's answer or reason for reopening an asked or done comment and opens it again; this queues no work: once the earlier job is over, ask again (POST /api/computers/{id}/comments/ask) with the version returned here. Send the version of the comment the owner saw: a reply that landed since gives comment_changed, so the owner reads it first. A done comment may also be reopened, preserving its thread and clearing its fixed release.","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":"Resolve computer comment - Cool Computers","buildId":"dpl_Aw98ji4XvBsgtZwL1VrkUF9ehFqz","deploymentId":"dpl_Aw98ji4XvBsgtZwL1VrkUF9ehFqz","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-CQGbdtm4.js","utils-D88A1f-Z.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-ChqWdz1A.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-yBrxdh_6.js","snippetPresets-BgqDrFJC.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","ApiExamples-Duxc2rZw.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-C7jidOil.js","shallow-xkjpHm-U.js","getApiPlaygroundDisplay-fE3rVpvL.js","CodeSnippet-LgxljKed.js","CodeSnippets-D-pXWDHq.js","Page-C2-BijcO.js","getPastedJson-CLRcu-uo.js","icon-Cxirpjgo.js","MethodPill-D49eqY5e.js","DuplicateIcon-CivCz5Rp.js","createIcon-D71qL3f5.js","DynamicMarkdown-BcGRTrw6.js","SectionHeading-DzaqmmSD.js","axios-vUo_bRtp.js","Markdown-CZqUYmMp.js","clsx-B6IZIRsp.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-B0ZV6X5T.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-MqLyPtsW.js"]}