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.
Authorization
chaveDeApi Chave de API da organização, criada nas configurações. Envie-a em Authorization: Bearer <sua chave>.
In: header
Response Body
application/json
curl -X GET "https://example.com/v1/apps/me/agents"{ "agents": [ { "key": "string", "agent_id": "string", "name": "string", "description": "string", "avatar": "string", "is_default": true } ]}Desfaz o vínculo da própria conta
A aplicação desfaz o vínculo da PESSOA cuja credencial ela apresenta: revoga a chave, apaga a credencial de ferramenta e remove a pessoa do time de destino. O pertencimento à organização permanece — ela pode ter conta própria e outros vínculos. A chave usada nesta chamada é revogada por ela, e não deve ser reusada.
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.