VolundOS
Referência da APIExecução

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.

Atualizado em 04 de novembro de 2026
POST
/v1/runs/{runId}/artifacts/{artifactId}/comments

Authorization

chaveDeApi
AuthorizationBearer <token>

Chave de API da organização, criada nas configurações. Envie-a em Authorization: Bearer <sua chave>.

In: header

Path Parameters

runId*string

Identificador do run. É o mesmo da conversa: um run continua na mesma thread.

artifactId*string

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"}