Atualizado em 17 de outubro de 2026

Considerações

  • Exige o escopo file-manager:read e que o usuário veja o item; senão, 404.
  • Papéis: visualizar só lê; editar cria dentro, envia, renomeia, move e edita documento; gerenciar também muda quem acessa e tira da Empresa. O papel vale no item e em tudo dentro dele, e fica o maior entre o item e as pastas acima.
  • Na Empresa o item é da empresa (owner vem nulo). Quem não tem papel recebe o acesso da pasta: everyone_edit (todos editam), everyone_view (todos veem, o padrão) ou restricted (só a lista). company_access é a escolha do item (inherit segue a pasta de cima) e effective_company_access é o que vale.
  • my_permission e can_manage dizem o que a credencial pode fazer no item.

Referência

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

Como fazer

cURL
curl "$MICORE_BASE_URL/file-manager/items/497/sharing" \
  -H "Authorization: Bearer $MICORE_TOKEN" \
  -H "Accept: application/json"

Resposta

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.