VolundOS
Referência da APIExecução

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.

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

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