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

# List prompts

`GET /prompts/v1`

## Request

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

Returns prompts you can access in your workspace.

## Query parameters

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

## Response `200`

Prompts returned successfully

- ListPromptsResponse
  - `prompts` Prompt[], required
    - `id` string, uuid, required: Unique identifier for the prompt.
    - `title` string, required: Prompt title.
    - `prompt` string, required: Prompt content.
    - `createdBy` string, uuid, nullable: User ID of the prompt creator.
    - `promptFolderId` string, uuid, nullable: Folder ID the prompt is assigned to.
    - `sharedWithWorkspace` boolean, required: Whether the prompt is shared with the workspace.
    - `createdAt` string, date-time, nullable: ISO 8601 timestamp for prompt creation.
    - `updatedAt` string, date-time, nullable: ISO 8601 timestamp for the latest prompt 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/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)