VolundOS
Referência da APIExecução

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.

Atualizado em 04 de novembro de 2026
PATCH
/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.

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Ao menos um dos dois campos.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X PATCH "https://example.com/v1/runs/string/artifacts/string/sharing" \  -H "Content-Type: application/json" \  -d '{}'
{  "visibility": "private",  "general_access_level": "view",  "url": "string",  "public_url": "string",  "embed_url": "string",  "can_manage_sharing": true}