VolundOS
Referência da APIGovernança

Ingerir consumo de sistema de IA de terceiro

Recebe assentos e consumo de um ativo em lote, numa única transação. Reenviar o mesmo lote não duplica: a resposta separa received de created, e é essa diferença que evidencia a idempotência. Um lote pode declarar replace_period para afirmar que é o relato completo do que cobre; nesse caso batch_id é obrigatório, porque é ele que identifica a rodada e impede a substituição de apagar o que a própria rodada acabou de gravar. Além do escopo, exige da identidade da chave a permissão third_party_usage_manage: o consumo por assento é dado individual de cada pessoa. Exige o escopo governance:write.

Atualizado em 21 de setembro de 2026
POST
/v1/governance/usage

Authorization

chaveDeApi
AuthorizationBearer <token>

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

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/v1/governance/usage" \  -H "Content-Type: application/json" \  -d '{}'
{  "ok": true,  "asset_id": "string",  "seats": {    "received": 0,    "created": 0  },  "usage": {    "received": 0,    "created": 0,    "replaced": 0  },  "unmatched_seats": [    {      "seat_id": "string",      "external_user_key": "string",      "email": "string"    }  ],  "unmatched_count": 0}