---
title: "List prompt folders"
method: GET
path: "/prompts/v1/folders"
tags: ["Prompts"]
---

# List prompt folders

`GET /prompts/v1/folders`

## Request

- Base URL: `https://api.langdock.com`
- URL: `https://api.langdock.com/prompts/v1/folders`
- Auth: HTTP bearer

Returns prompt folders you can access in your workspace.

## Query parameters

- `limit` integer
- `cursor` string, uuid
- `query` string
- `sharedWithWorkspace` 'true' | 'false'

## Response `200`

Prompt folders returned successfully

- ListPromptFoldersResponse
  - `folders` PromptFolder[], required
    - `id` string, uuid, required: Unique identifier for the prompt folder.
    - `name` string, required: Folder name.
    - `createdBy` string, uuid, required: User ID of the folder creator.
    - `sharedWithWorkspace` boolean, required: Whether the folder is shared with the workspace.
    - `sharedWithGroupId` string, uuid, nullable: Group ID the folder is shared with.
    - `createdAt` string, date-time, required: ISO 8601 timestamp for folder creation.
    - `updatedAt` string, date-time, required: ISO 8601 timestamp for the latest folder update.
  - `nextCursor` string, uuid: Cursor for the next page, if more results are available.

## Other responses

- `400`: Invalid query parameter
- `401`: Invalid or missing API key
- `403`: Missing required scope or access
- `429`: Rate limit exceeded
- `500`: Internal server error

## Changes

- **2026-11-03** `c62bf90b4013`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/langdock/apis/langdock-api/changes/prompts/v1/folders/get.md)

---

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