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.
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/embed" \ -H "Content-Type: application/json" \ -d '{}'{ "url": "string", "expires_at": "2019-08-24T14:15:22Z", "version": 0, "board": { "file": "string", "title": "string", "w": 0, "h": 0 }}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.
Compartilhamento de um artefato do run
Quem abre o artefato, o que o acesso geral pode fazer e, quando público, o link sem conta. Exige o escopo runs:read.