Listar pastas e arquivos

Atualizado em 17 de outubro de 2026

Considerações

Exige o escopo file-manager:read e a permissão de visualizar em Gerenciador de Arquivos.
Só aparece o que o usuário pode ver, com a regra do painel: o que é da Empresa (menos as pastas restritas em que ele não tem papel), o que é dele e o que foi compartilhado com ele ou com um time dele. Pastas privadas de outras pessoas e tudo dentro delas ficam de fora.
Cada item traz path, o caminho de pastas até ele (ex.: Empresa/Fotos). Com ele dá para remontar a árvore a partir de uma listagem recursiva.
Com search, a busca desce pelas subpastas, como no painel.
Filtre por type (folder, file, document) e extension (ex.: pdf). Para listar só pastas, use type=folder.
Ordene com sort (name, created_at, updated_at, size; com - na frente fica decrescente). Sem sort, pastas vêm primeiro e depois o nome.
A resposta é paginada: até 100 por página com per_page (padrão 50); siga links.next até acabar.
Itens dentro de pasta arquivada (lixeira) não aparecem.

Referência

GET /file-manager/items na Referência da API

Como fazer

Um nível da pasta:

cURL

curl "$MICORE_BASE_URL/file-manager/items?parent_id=93" \
  -H "Authorization: Bearer $MICORE_TOKEN" \
  -H "Accept: application/json"

Todos os PDFs abaixo da pasta:

cURL

curl "$MICORE_BASE_URL/file-manager/items?parent_id=93&recursive=true&type=file&extension=pdf&per_page=100" \
  -H "Authorization: Bearer $MICORE_TOKEN" \
  -H "Accept: application/json"

O gerenciador inteiro:

cURL

curl "$MICORE_BASE_URL/file-manager/items?recursive=true&per_page=100" \
  -H "Authorization: Bearer $MICORE_TOKEN" \
  -H "Accept: application/json"

Resposta

cURL

{
  "data": [
    {
      "id": 497,
      "name": "Obra Centro",
      "type": "folder",
      "extension": null,
      "mime_type": null,
      "size": null,
      "parent_id": 93,
      "path": "Empresa/Fotos",
      "owner_id": 2,
      "visibility": "company",
      "created_at": "2026-10-01T10:00:00-03:00",
      "updated_at": "2026-10-22T09:10:02-03:00"
    },
    {
      "id": 1444,
      "name": "IMG_9512",
      "type": "file",
      "extension": "mov",
      "mime_type": "video/quicktime",
      "size": 215912345,
      "parent_id": 497,
      "path": "Empresa/Fotos/Obra Centro",
      "owner_id": 2,
      "visibility": "company",
      "created_at": "2026-10-21T23:48:11-03:00",
      "updated_at": "2026-10-22T09:10:02-03:00"
    }
  ],
  "links": {
    "first": "…/file-manager/items?page=1",
    "last": "…/file-manager/items?page=3",
    "prev": null,
    "next": "…/file-manager/items?page=2"
  },
  "meta": {
    "current_page": 1,
    "last_page": 3,
    "per_page": 50,
    "total": 131
  }
}

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