VolundOS
Referência da APIAgentes do app

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.

Atualizado em 21 de setembro de 2026
GET
/v1/apps/me/agents

Authorization

chaveDeApi
AuthorizationBearer <token>

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    }  ]}