Comentar num ponto de uma prancheta
Abre uma thread de comentário num ponto de uma prancheta de um canvas de design deste run, com a pessoa dona da chave como autora. Quem chama manda a prancheta e a fração do ponto (a conta está em POST /v1/runs/{runId}/artifacts/{artifactId}/embed); a âncora é gravada no formato do editor, então a thread aparece no canvas no mesmo ponto, com o título da prancheta como lugar. Quando a chave é de uma aplicação vinculada, o comentário leva essa aplicação, e o canvas mostra "pelo <aplicação>" ao lado da hora. O comentário NÃO acorda o agente: ele fica no canvas, e o agente o lê pela ferramenta de artefato quando o fluxo de quem chamou pedir. Exige o escopo runs:execute.
Authorization
chaveDeApi Chave de API da organização, criada nas configurações. Envie-a em Authorization: Bearer <sua chave>.
In: header
Path Parameters
Identificador do run. É o mesmo da conversa: um run continua na mesma thread.
Identificador do artefato.
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
application/json
application/json
application/json
curl -X POST "https://example.com/v1/runs/string/artifacts/string/comments" \ -H "Content-Type: application/json" \ -d '{ "board": "string", "x": 0, "y": 0, "text": "string" }'{ "thread_id": "string", "comment_id": "string", "anchor": "string", "label": "string"}Listar os comentários de um artefato do run
As threads de comentário do artefato, com as respostas. Quando a âncora é um ponto numa prancheta que existe na versão atual, a thread traz `board`, `x` e `y` (frações de 0 a 1), para quem embute desenhar o marcador; senão os três vêm `null`. Numa página publicada comum, os comentários são só de quem a criou: para outras pessoas a lista vem vazia. Exige o escopo runs:read.
Decidir uma aprovação
Aprova ou recusa uma aprovação pendente e retoma o agente. A permissão é avaliada como a pessoa dona da chave. Plano proposto por um turno com `plan_mode: true` não é decidido aqui: a resposta é 400 (`not_a_plan`), e a decisão vai em POST /v1/runs/{runId}/plan. Exige o escopo runs:execute.