Mudar quem acessa (papéis e Empresa)

Atualizado em 17 de outubro de 2026

Considerações

Exige o escopo file-manager:write e o papel gerenciar no item da Empresa (no privado, basta editar).
PATCH parcial: só as chaves enviadas mudam. users e teams substituem a lista anterior; para tirar todos, envie a lista vazia.
O papel de um time vale para os integrantes ativos dele (ids em GET /teams).
visibility só muda em item da raiz; dentro de pasta, mova o item. Levar à Empresa deixa o item em everyone_view e dá gerenciar a quem publicou.
Numa subpasta da Empresa, company_access não pode ser mais aberto que o da pasta de cima (422); inherit volta a seguir a de cima.
Quem salva não pode ficar sem gerenciar num item da Empresa (422): mantenha você ou um time seu com esse papel.

Referência

PATCH /file-manager/items/{item}/sharing na Referência da API

Como fazer

Fechar a pasta do RH para o time do RH e uma gestora:

cURL

curl -X PATCH "$MICORE_BASE_URL/file-manager/items/497/sharing" \
  -H "Authorization: Bearer $MICORE_TOKEN" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{
    "company_access": "restricted",
    "users": [
        {
            "id": 12,
            "permission": "gerenciar"
        }
    ],
    "teams": [
        {
            "id": 3,
            "permission": "editar"
        }
    ]
}'

Deixar uma pasta antiga só para leitura de quem não tem papel:

cURL

curl -X PATCH "$MICORE_BASE_URL/file-manager/items/93/sharing" \
  -H "Authorization: Bearer $MICORE_TOKEN" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{
    "company_access": "everyone_view"
}'

Resposta

Devolve o compartilhamento atualizado, no mesmo formato da leitura.

cURL

{
  "data": {
    "id": 497,
    "name": "RH",
    "type": "folder",
    "visibility": "company",
    "is_root": true,
    "owner": null,
    "company_access": "restricted",
    "inherited_company_access": null,
    "effective_company_access": "restricted",
    "my_permission": "gerenciar",
    "can_manage": true,
    "can_change_visibility": true,
    "users": [
      { "user_id": 12, "name": "Ana Souza", "email": "ana@empresa.com.br", "permission": "gerenciar" }
    ],
    "teams": [
      { "team_id": 3, "name": "Recursos Humanos", "permission": "editar" }
    ]
  }
}

Precisa de ajuda?Use o request ID e abra um chamado no miCore se encontrar uma divergência.