---
title: "List folders"
method: GET
path: "/tables/folders/"
tags: ["tables"]
---

# List folders

`GET /tables/folders/`

## Request

- Base URL: `https://api.getoneprofile.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.getoneprofile.ai/tables/folders/`
- Auth: one of:
  - API key in header `X-API-Key`
  - HTTP bearer

Every live folder in the workspace, at every level, by name. parent_id says where each one sits. Each says how many tables and folders it holds, and when the caller last opened a table in it.

## Response `200`

Successful Response

- TableFolderListSchema: Every live folder in the workspace, at every level.
  - `folders` TableFolderSchema[], required: The folders, by name. parent_id says where each one sits.
    - `created_at` string, date-time, required
    - `folder_count` integer: Folders directly in it.
    - `id` string, uuid, required
    - `last_viewed_at` string, date-time, nullable: When the CALLING USER last opened any table in it, at any depth; null when they never have.
    - `name` string, required
    - `nested_archived_count` integer: Archived tables in it at any depth, which go to Trash with it too.
    - `nested_table_count` integer: Tables in it at any depth, archived ones aside. What deleting it would send to Trash, archived tables added.
    - `owner_display_name` string, nullable: The owner's name, resolved for display.
    - `owner_user_id` string, nullable, required: Who to ask about it: whoever made it, unless somebody changed it.
    - `parent_id` string, uuid, nullable, required: The folder it sits in; null for the top level.
    - `table_count` integer: Tables directly in it, archived ones aside.
    - `updated_at` string, date-time, required

## Other responses

- `401`: Unauthorized
- `403`: Forbidden
- `422`: Invalid request made to the API.
- `500`: Internal server error.
- `502`: Bad gateway error.
- `503`: Service unavailable.

---

[API](https://skmtc.dev/getoneprofile/apis/api-reference-oneprofile.md) · [All operations](https://skmtc.dev/getoneprofile/apis/api-reference-oneprofile/llms.txt) · [OpenAPI document](https://skmtc.dev/getoneprofile/apis/api-reference-oneprofile/revisions/4a6bd71e3f02?raw)