---
title: "GET /api/collection/root/items"
method: GET
path: "/api/collection/root/items"
tags: ["/api/collection"]
---

# GET /api/collection/root/items

`GET /api/collection/root/items`

Fetch objects that the current user should see at their root level. As mentioned elsewhere, the 'Root' Collection
  doesn't actually exist as a row in the application DB: it's simply a virtual Collection where things with no
  `collection_id` exist. It does, however, have its own set of Permissions.

  This endpoint will actually show objects with no `collection_id` for Users that have Root Collection
  permissions, but for people without Root Collection perms, we'll just show the objects that have an effective
  location of `/`.

  This endpoint is intended to power a 'Root Folder View' for the Current User, so regardless you'll see all the
  top-level objects you're allowed to access.

  By default, this will show the 'normal' Collections namespace; to view a different Collections namespace, such as
  `snippets`, you can pass the `?namespace=` parameter.

  By default, library collections are excluded from the results; to include them, pass `?include_library=true`.

  Note that this endpoint should return results in a similar shape to `/api/dashboard/:id/items`, so if this is
  changed, that should too.

## Query parameters

- `models` string[], nullable
- `collection_type` 'remote-synced'
- `include_can_run_adhoc_query` boolean, nullable, required
- `archived` boolean, nullable, required
- `namespace` string, nullable
- `include_library` boolean, nullable, required
- `pinned_state` 'is_not_pinned' | 'is_pinned' | 'all', nullable
- `sort_column` 'model' | 'name' | 'last_edited_by' | 'last_edited_at' | 'description', nullable
- `sort_direction` 'desc' | 'asc', nullable
- `official_collections_first` boolean, nullable
- `show_dashboard_questions` boolean, nullable

## Response `2XX`

Successful response

## Other responses

- `4XX` — Client error response
- `5XX` — Server error response

---

[API](https://skmtc.net/metabase/apis/metabase-api.md) · [All operations](https://skmtc.net/metabase/apis/metabase-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/metabase/metabase-api/revisions/08b5a2bafb4f/schema)