VolundOS
Referência da APIGovernança

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.

Atualizado em 21 de setembro de 2026
GET
/v1/governance/usage/seats

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.

unmatched?string

true devolve só os assentos sem correspondência.

limit?integer

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

after?string

Cursor de keyset: devolve os assentos 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 assento 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/seats"
{  "asset_id": "string",  "seats": [    {      "id": "string",      "external_user_key": "string",      "email": "string",      "display_name": "string",      "provider_role": "string",      "seat_status": "string",      "user_id": "string",      "match_method": "string",      "quota_limit": 0,      "quota_unit": "string",      "updated_at": "2019-08-24T14:15:22Z"    }  ],  "truncated": true,  "next_after": "string"}

Ler consumo de sistema de IA de terceiro

Consumo agregado do período, por assento (group_by=seat) ou pelo total do ativo (group_by=asset). No total do ativo, o rateio não atribuído vem em coluna separada: somado ao consumo por assento, viraria consumo de gente. A janela é obrigatória e não tem default: uma janela implícita faria a mesma chamada devolver números diferentes conforme o dia. Além do escopo, exige da identidade da chave a permissão third_party_usage_view. Exige o escopo governance:read.

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.