---
title: "List Team Space folders"
method: GET
path: "/v1/workspaces/{workspaceId}/folders"
tags: ["Folders"]
---

# List Team Space folders

`GET /v1/workspaces/{workspaceId}/folders`

## Request

- Base URL: `https://shareout.site`
- URL: `https://shareout.site/v1/workspaces/{workspaceId}/folders`
- Auth: HTTP bearer

Top-level folders by default; `parent_id` lists one level below it, `all=1` returns every depth. Any member.

## Query parameters

- `parent_id` string
- `all` string

## Response `200`

Folders (unpaginated)

- object
  - `folders` Folder[]
    - `id` string
    - `name` string
    - `slug` string
    - `description` string, nullable
    - `artifact_count` integer
    - `parent_id` string, nullable: Team Space folders only.
    - `visibility` 'inherit' | 'public' | 'workspace' | 'private': Team Space folders only.
    - `subfolder_count` integer: Team Space folders only.
    - `path` string: Slug path; single-folder Team Space responses only.
    - `readme` string, nullable: Single-folder Team Space responses only.
    - `effective_visibility` string: Single-folder Team Space responses only.
    - `created_at` string, date-time
  - `can_create` boolean: Whether the caller may create folders in this workspace.

## Other responses

- `403`: Access denied

## Changes

- **2026-10-16** `96e883908d14`: 1 info
  - added the optional property `can_create` to the response with the `200` status
- **2026-10-13** `ed6fa61bd690`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/shareout/apis/shareout-rest-api/changes/v1/workspaces/:workspaceId/folders/get.md)

---

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