VolundOS
Referência da APIGovernança

Listar projetos de um sistema de IA de terceiro

Os projetos do ativo. unlinked=true devolve só os que não foram vinculados a um time — o consumo que a organização paga e não consegue ratear, que é o achado de governança desta dimensão. O vínculo projeto→time é sempre MANUAL: não há casamento automático por nome, então a ausência do vínculo é o estado inteiro. A chave do projeto PRESERVA A CAIXA — é o identificador opaco do provedor, e é por ele que alguém abre o projeto lá. O cursor de keyset a devolve como saiu. A resposta traz truncated: sem ele, uma lista que bateu no teto seria indistinguível de uma lista completa. Além do escopo, exige da identidade da chave a permissão third_party_usage_view. Exige o escopo governance:read.

Atualizado em 04 de novembro de 2026
GET
/v1/governance/usage/projects

Authorization

chaveDeApi
AuthorizationBearer <token>

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

In: header

Query Parameters

asset_id?string

Identificador do ativo. Informe asset_id ou external_ref.

external_ref?string

Referência externa do ativo.

asset_type?string

Tipo do ativo, para desambiguar external_ref.

unlinked?string

true devolve só os projetos sem time vinculado.

limit?integer

Teto da página (máximo 500). Valores acima são aparados.

after?string

Cursor de keyset: devolve os projetos cuja chave vem depois desta. Use o next_after da página anterior. Keyset e não offset porque a coleta escreve enquanto se pagina, e offset pularia projeto em silêncio.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/v1/governance/usage/projects"
{  "asset_id": "string",  "projects": [    {      "id": "string",      "external_project_key": "string",      "name": "string",      "project_status": "string",      "team_id": "string",      "updated_at": "2019-08-24T14:15:22Z",      "owner_external_key": "string",      "owner_display_name": "string",      "owner_override_seat_id": "e6ba2ebf-eee1-4254-aacf-b6ae04bac4cd"    }  ],  "truncated": true,  "next_after": "string"}

Listar assentos de um sistema de IA de terceiro

Os assentos do ativo. unmatched=true devolve só os que não foram correspondidos a um membro — a licença que a organização paga e não consegue atribuir a ninguém, que é o achado de governança. A resposta traz truncated: sem ele, uma lista que bateu no teto seria indistinguível de uma lista completa. Além do escopo, exige da identidade da chave a permissão third_party_usage_view. Exige o escopo governance:read.

Listar unidades de negócio com o gasto

As unidades de negócio da organização, com as pessoas, a parte de cada uma (inteiros de 1 a 100 que somam 100 por pessoa) e o gasto no período, em USD. O gasto de uma pessoa entra em cada unidade na proporção da parte dela, então a soma das unidades fecha com o total. A linha com `id` nulo é "Sem unidade": membros sem unidade e quem gastou e não é mais membro. Quando a pessoa dona da chave não vê o consumo de terceiros, `external_allowed` vem falso e `external_cost` vem zerado. Exige o escopo governance:read.