VolundOS
Referência da APIExecução

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.

Atualizado em 04 de novembro de 2026
GET
/v1/runs/{runId}/artifacts/{artifactId}/sharing

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.

Response Body

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/v1/runs/string/artifacts/string/sharing"
{  "visibility": "private",  "general_access_level": "view",  "url": "string",  "public_url": "string",  "embed_url": "string",  "can_manage_sharing": true}

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.

Trocar o compartilhamento de um artefato do run

O menu Compartilhar do painel pela API, com a mesma regra e a mesma permissão: quem criou o artefato, quem gerencia os agentes da organização ou quem configura o agente. O campo ausente fica como está. Na primeira ida para `public` o servidor gera o link; voltar a outro nível desliga o link na hora, e tornar público de novo devolve o MESMO endereço. O link público pode ser embutido numa moldura pelas origens das aplicações vinculadas ativas da organização (Configurações > Aplicações), com o app e os domínios da organização; quem abre embutido vê como visitante, só para ver. O tipo Dashboard não tem link público. Exige o escopo runs:execute.