---
title: "List App Folder Contents"
method: GET
path: "/v1/folders/app/contents"
tags: ["Folders"]
---

# List App Folder Contents

`GET /v1/folders/app/contents`

## Request

- Base URL: `https://api.lucid.co`
- URL: `https://api.lucid.co/v1/folders/app/contents`
- Auth: OAuth 2
  - Authorization code: `https://lucid.app/oauth2/authorize`
  - Token URL: `https://api.lucid.co/oauth2/token` scopes: `folder:readonly`, `lucidchart.document.app.folder`, `lucidspark.document.app.folder`, `lucidscale.document.app.folder`
- TypeScript: <https://skmtc.dev/lucid/apis/lucid-rest-api/docs/v1/folders/app/contents/get.ts> (a function with typed inputs; its response is checked against the schema)

Lists the contents of the OAuth2 client's app project folder for the authenticated user. The app project folder is automatically resolved from the OAuth2 client ID associated with the access token. Results are paginated.

## Valid Authentication Methods

**OAuth 2.0 User Token Scopes:**
- `folder:readonly`
- `lucidchart.document.app.folder`
- `lucidspark.document.app.folder`
- `lucidscale.document.app.folder`

## Query parameters

- `filter` 'type=folder'

## Response `200`

OK with an array of Folder Content Resources containing information about the contents of the app project folder.

- FolderContent[]
  - `id` union, required: Unique ID of the folder or document being referred to. This field will be a Number for folders and a UUID for documents.
    - string, uuid
    - number
  - `type` 'folder' | 'document', required: * folder - Type denoting that the Folder Content Resource is a folder and will have a Number id field and no product field. * document - Type denoting that the Folder Content Resource is a document and will have a UUID id field and will contain a product field.
  - `name` string, required: Name of the folder or document
  - `isShortcut` boolean, required: A boolean value indicating whether or not the folder or document is a shortcut.
  - `accountId` integer, nullable, required: ID of the Lucid account that owns the Folder Content Resource.
  - `product` 'lucidchart' | 'lucidscale' | 'lucidspark': The Lucid Suite product that a document was created in.

## Other responses

- `403`: Forbidden if the authenticated user does not have permission to the app project folder.
- `404`: Not Found if no app project folder can be resolved for the OAuth2 client.

## Changes

- **2026-11-03** `9c2c917ec59c`: 4 info
  - added the new optional `query` request parameter `filter`
  - added the non-success response with the status `403`
  - added the non-success response with the status `404`
  - added the required property `items/accountId` to the response with the `200` status

[Operation history](https://skmtc.dev/lucid/apis/lucid-rest-api/changes/v1/folders/app/contents/get.md)

---

[API](https://skmtc.dev/lucid/apis/lucid-rest-api.md) - [All operations](https://skmtc.dev/lucid/apis/lucid-rest-api/llms.txt) - [OpenAPI document](https://skmtc.dev/lucid/apis/lucid-rest-api/revisions/9c2c917ec59c?raw)