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.
Authorization
chaveDeApi 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"}Os agentes que este app oferece
Devolve os agentes que o app do VolundOS oferece a quem usa a aplicação publicada: apelido, nome, descrição, avatar e qual é o padrão. Responde ao token que o app obtém pela troca (`urn:ietf:params:oauth:grant-type:token-exchange`) em nome da pessoa logada nele — uma chave de API não representa um app e recebe 403. Quem é o app sai do token, e não do caminho: por isso `me`. Só os agentes HABILITADOS aparecem — um agente desligado não é oferta. Exige o escopo runs:execute.
Encerrar o chat embutido do app
Revoga uma sessão criada por `POST /v1/apps/me/embed-sessions`, só do mesmo app e da mesma pessoa do token. O iframe recebe a sessão encerrada no pedido seguinte. Idempotente: 204 também quando já estava encerrada. Exige o escopo runs:execute.