VolundOS
Referência da APIAgentes do app

Abrir o chat embutido para a pessoa logada no app

Cria a sessão do chat embutido de um agente que o app oferece, para a pessoa logada nele, e devolve o `embed_url` para o `src` do iframe. A conversa roda como a PRÓPRIA pessoa (membro da organização), no canal `app`: o MCP do app funciona em modo delegado, valem as ferramentas e a cota dela, e a conversa aparece no VolundOS. O que o iframe não decide (aprovação de ferramenta, cofre) a pessoa decide lá. Responde ao token que o app obtém pela troca (`urn:ietf:params:oauth:grant-type:token-exchange`) em nome da pessoa: quem é o app e quem é a pessoa saem do token. Uma chave de API não representa um app e recebe 403. O corpo é opcional; `agent` é o apelido do agente no app (ausente, o padrão). Campo fora da lista responde 400 `invalid_request`: não há `user`, `restrictions`, `mcp` nem `context`, que são do chat embutido de aplicação vinculada. Exige o escopo runs:execute.

Atualizado em 04 de novembro de 2026
POST
/v1/apps/me/embed-sessions

Authorization

chaveDeApi
AuthorizationBearer <token>

Chave de API da organização, criada nas configurações. Envie-a em Authorization: Bearer <sua chave>.

In: header

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

application/json

curl -X POST "https://example.com/v1/apps/me/embed-sessions" \  -H "Content-Type: application/json" \  -d '{}'
{  "session_id": "1ffd059c-17ea-40a8-8aef-70fd0307db82",  "embed_url": "string",  "expires_at": "2019-08-24T14:15:22Z",  "thread_id": "1de43264-67cb-48af-89f9-e865c375bb84"}