---
title: "Get folder contents"
method: GET
path: "/v1/folders/{folder_id}/contents"
tags: ["Folders"]
---

# Get folder contents

`GET /v1/folders/{folder_id}/contents`

Retrieve all items contained within a specific folder. Returns a paginated list of projects, docs, channels, dashboards, agents, and child folders that are direct children of the specified folder.

Each item includes its type, title, creation date, and author. Use this endpoint to browse a folder's contents or build a file-explorer-style navigation for your workspace.

Results can be sorted by creation date or title and are paginated.

> 🚧 Permissions
>
> Please check you have the relevant permissions required to access this resource. This may include specific permissions on the object itself or its parent, or having the correct user role if you're making updates.

## Path parameters

- `folder_id` string, required

## Query parameters

- `page` object
  - `start_cursor` string
  - `limit` integer, nullable
- `sort` union
  - 'created_at:asc' | 'created_at:desc' | 'title:asc' | 'title:desc'
  - string[]

## Response `200`

200

- object
  - `data` object[], required
    - `type` 'project' | 'doc' | 'channel' | 'dashboard' | 'agent' | 'folder', required
    - `id` string, required
    - `url` string, nullable — The URL of this resource in the Dovetail web app, or null if unavailable. This field is experimental and may change without notice.
    - `title` string, required
    - `created_at` string, required
    - `author_id` string, nullable, required
  - `page` object, required
    - `total_count` number, required — Total number of items matching the query.
    - `has_more` boolean, required — Whether there are more items beyond the current page.
    - `next_cursor` string, nullable, required — Cursor to pass as `page[start_cursor]` to fetch the next page. Null when there are no more results.

## Other responses

- `400` — 400
- `401` — 401
- `403` — 403
- `404` — 404
- `422` — 422
- `429` — 429
- `500` — 500

---

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