Listar os artefatos de um run
Os artefatos que o agente publicou nesta conversa, do mais recente para o mais antigo, no máximo 200, sem os removidos. Só aparecem os que a pessoa dona da chave pode ver. Num canvas de design, cada artefato traz as pranchetas da versão atual, na ordem do canvas, com o tamanho e a âncora da prancheta inteira; nos outros tipos, `boards` vem vazio. Exige o escopo runs:read.
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.
Response Body
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/v1/runs/string/artifacts"{ "artifacts": [ { "id": "string", "title": "string", "type": "string", "version": 0, "updated_at": "2019-08-24T14:15:22Z", "url": "string", "visibility": "private", "general_access_level": "view", "public_url": "string", "embed_url": "string", "boards": [ { "file": "string", "title": "string", "w": 0, "h": 0, "anchor": "string" } ] } ]}Parar o turno de um run
Para o turno em andamento, como o botão de parar da conversa. O turno vivo no sandbox é parado, inclusive o que espera aprovação ou pergunta, em alguns segundos, e a conversa ganha a mensagem "Execução interrompida pelo usuário.". Depois disso, `GET /v1/runs/{runId}` responde `failed`. Idempotente: com o turno já terminado, ou a conversa esperando o cofre, responde `stopped: false`. Só para o turno com execução registrada no sandbox. Turno em andamento sem ela recebe 409 `run_not_stoppable`: o run síncrono, o de `callback_url` e o de canal conduzido pelo servidor não são interrompidos de fora. Um run de `/stream` ou `async: true` também recebe o 409 nos primeiros segundos, antes de registrar a execução; repetir o pedido logo depois para ele. Exige o escopo runs:execute.
Endereço para embutir uma prancheta
Cunha um endereço só de leitura para mostrar uma prancheta de um canvas de design deste run numa moldura de outra aplicação. A credencial é presa à versão atual e à prancheta, e vale por uma hora: ela abre só essa prancheta e os arquivos que ela cita, e não o resto do canvas. A página abre a prancheta pedida (ou a primeira do canvas) sozinha, encaixada na moldura e centralizada, sem barra. Só podem emoldurá-la o próprio app, os domínios da organização e as origens declaradas nas aplicações vinculadas ativas da organização (Configurações > Aplicações). A resposta traz a prancheta com o tamanho, para quem embute converter um clique em fração da prancheta: com a moldura de `W`x`H` px, `s = min(W/w, H/h)`, `ox = (W - w*s)/2`, `oy = (H - h*s)/2`, e o clique em `(cx, cy)` vira `x = (cx - ox)/(w*s)`, `y = (cy - oy)/(h*s)`, válido só entre 0 e 1. Exige o escopo runs:execute.