Consumo por pessoa da aplicação
O consumo de cada pessoa de uma aplicação: as do chat embutido e as indicadas com `user` nos runs da API, que são as mesmas pessoas. Cada linha traz o id que a aplicação mandou (`user`), o nome, as conversas, os turnos, os tokens, o custo em dólares, o último uso e a quebra por agente. `total` soma todas as pessoas do recorte, antes da página. A aplicação tem de ser da organização da chave; de outra organização, ou inexistente, a resposta é 404 `app_not_found`. Quem emitiu a chave precisa da leitura de consumo da Governança ou de administrar as aplicações (senão, 403 `forbidden`). Dado de todos os agentes, então a chave restrita a agentes é recusada (`agent_not_allowed`). Exige o escopo app_users:read.
Authorization
chaveDeApi Chave de API da organização, criada nas configurações. Envie-a em Authorization: Bearer <sua chave>.
In: header
Path Parameters
Id da aplicação (Configurações > Aplicações).
uuidQuery Parameters
O mesmo de GET /v1/governance/consumption: 24h, 7d, 30d (padrão), 90d, um mês (2026-10) ou um intervalo (2026-09-15..2026-10-10), no fuso da organização.
Só esta pessoa (o id que a aplicação manda em user).
length <= 200Pessoas por página, de 1 a 500.
1 <= value <= 500100Quantas pessoas pular.
0 <= value0Response Body
application/json
application/json
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/v1/apps/497f6eca-6276-4993-bfeb-53cbbbba6f08/usage"{ "app": { "id": "string", "name": "string" }, "period": { "periodo": "string", "since": "2019-08-24T14:15:22Z", "until": "2019-08-24T14:15:22Z" }, "users": [ { "user": "string", "name": "string", "conversations": 0, "turns": 0, "tokens": { "input": 0, "output": 0 }, "cost_usd": 0, "last_used_at": "2019-08-24T14:15:22Z", "agents": [ { "agent_id": "string", "name": "string", "conversations": 0, "turns": 0, "tokens": { "input": 0, "output": 0 }, "cost_usd": 0 } ] } ], "total": { "users": 0, "conversations": 0, "turns": 0, "tokens": { "input": 0, "output": 0 }, "cost_usd": 0 }, "limit": 0, "offset": 0}Apagar tema
Apaga o tema. As aplicações que o tinham como padrão voltam para a marca da organização, e a resposta lista quais eram. Exige o escopo themes:write.
Criar sessão de chat embutido
Cria a sessão de um usuário da sua plataforma e devolve o `embed_url` para o `src` do iframe. O usuário não precisa de conta: ele é identificado pelo `user.id` que você manda. `restrictions` só restringe o que o agente já tem, `mcp` leva os cabeçalhos (só `authorization` e `x-*`) que o agente apresenta aos servidores MCP dos hosts que a aplicação declarou, e `context` entra no turno como dado da aplicação. O código no fragmento do `embed_url` vale 120 segundos e uma vez só.