VolundOS
Referência da APIGovernança

Definir as unidades de uma pessoa

Substitui as unidades de uma pessoa, inteiras. As partes são inteiros de 1 a 100 que somam 100, sem unidade repetida; lista vazia deixa a pessoa em "Sem unidade". O banco recusa qualquer combinação que não feche em 100. Exige o escopo governance:write.

Atualizado em 17 de outubro de 2026
PUT
/v1/governance/units/members/{userId}

Authorization

chaveDeApi
AuthorizationBearer <token>

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

In: header

Path Parameters

userId*string

Identificador da pessoa (membro da organização).

Formatuuid

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

curl -X PUT "https://example.com/v1/governance/units/members/497f6eca-6276-4993-bfeb-53cbbbba6f08" \  -H "Content-Type: application/json" \  -d '{    "shares": [      {        "unit_id": "5becc822-b69e-4e66-a762-ad8e868dcab6",        "share": 1      }    ]  }'
{  "ok": true}

Listar as unidades de cada membro

As unidades da organização e as partes de cada membro. Membro sem unidade vem com `units` vazio. A identidade de sistema da organização não aparece. Exige o escopo governance:read.

Listar pipelines

Os pipelines da organização da chave que a pessoa dona dela pode ver (os dela, os compartilhados com ela e os dos times dela; quem tem agents.manage_all vê todos), para descobrir os identificadores sem entrar na interface. É a única operação de pipeline que uma chave recém-criada não alcança: ela pede o domínio do recurso, enquanto disparar e acompanhar pedem o domínio de execução. Exige o escopo pipelines:read.