VolundOS
Referência da APIGovernança

Criar unidade de negócio

Cria uma unidade. Quem já está em N unidades entra com 1/(N+1) e as outras partes dessa pessoa encolhem na proporção. A operação vai para a trilha de auditoria da Governança. Exige o escopo governance:write.

Atualizado em 17 de outubro de 2026
POST
/v1/governance/units

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/units" \  -H "Content-Type: application/json" \  -d '{    "name": "string"  }'
{  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08"}

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.

Editar unidade de negócio

Renomeia a unidade e, com `user_ids`, deixa nela exatamente essas pessoas: quem sai tem as outras partes refeitas para 100, quem entra é repartido como na criação. Sem `name`, o nome atual fica. Exige o escopo governance:write.