> ## Documentation Index
> Fetch the complete documentation index at: https://docs.langdock.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Prompt-Ordner auflisten

> Rufe Prompt-Ordner in deinem Workspace ab

Gibt Prompt-Ordner zurück, auf die du in deinem Workspace Zugriff hast. Nutze Query-Parameter zum Paginieren, Suchen oder Filtern nach Workspace-Freigabe.

## Basis-URL

```
https://api.langdock.com/prompts/v1/folders
```

<Warning>
  **Dedicated Deployments**

  Ersetze `api.langdock.com` durch `<your-deployment-url>/api/public` in allen Anfragen.
</Warning>

## Erforderliche Scopes

Dieser Endpoint erfordert den `PROMPT_API` Scope.

## Parameter

| Parameter             | Typ     | Erforderlich | Beschreibung                                                        |
| --------------------- | ------- | ------------ | ------------------------------------------------------------------- |
| `limit`               | integer | Nein         | Anzahl der zurückzugebenden Ordner. Standard: `50`. Maximum: `250`. |
| `cursor`              | string  | Nein         | Cursor aus der vorherigen Antwort für die Pagination.               |
| `query`               | string  | Nein         | Suchanfrage, die gegen den Ordnernamen geprüft wird.                |
| `sharedWithWorkspace` | string  | Nein         | Nach Workspace-Freigabe filtern. Erlaubte Werte: `true`, `false`.   |

## Beispiel

```javascript theme={null}
const axios = require("axios");

async function listPromptFolders() {
  const response = await axios.get("https://api.langdock.com/prompts/v1/folders", {
    params: {
      limit: 25,
      query: "support"
    },
    headers: {
      Authorization: "Bearer YOUR_API_KEY"
    }
  });

  console.log("Folders:", response.data.folders);
  return response.data.nextCursor;
}

listPromptFolders();
```

## Antwortformat

### Erfolgsantwort (200 OK)

```typescript theme={null}
{
  folders: Array<{
    id: string;
    name: string;
    createdBy: string;
    sharedWithWorkspace: boolean;
    sharedWithGroupId: string | null;
    createdAt: string;
    updatedAt: string;
  }>;
  nextCursor?: string;
}
```

## Beispielantwort

```json theme={null}
{
  "folders": [
    {
      "id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
      "name": "Support templates",
      "createdBy": "550e8400-e29b-41d4-a716-446655440000",
      "sharedWithWorkspace": false,
      "sharedWithGroupId": null,
      "createdAt": "2026-07-28T10:30:00.000Z",
      "updatedAt": "2026-07-28T10:30:00.000Z"
    }
  ],
  "nextCursor": "7c9e6679-7425-40de-944b-e07fc1f90ae7"
}
```

## Fehlerbehandlung

| Statuscode | Beschreibung                                             |
| ---------- | -------------------------------------------------------- |
| 400        | Ungültiger Query-Parameter                               |
| 401        | Ungültiger oder fehlender API Key                        |
| 403        | Fehlender `PROMPT_API` Scope oder kein Workspace-Zugriff |
| 429        | Rate Limit überschritten                                 |
| 500        | Interner Serverfehler                                    |

<Info>
  Langdock blockiert bewusst Browser-basierte Anfragen, um deinen API-Schlüssel zu schützen und die Sicherheit deiner Anwendungen zu gewährleisten. Weitere Informationen findest du in unserem Guide zu [Best Practices für API-Schlüssel](/de/admin/ai-adoption-and-rollout/best-practices/api-key-best-practices).
</Info>


## OpenAPI

````yaml GET /prompts/v1/folders
openapi: 3.0.0
info:
  title: Langdock API
  version: 3.0.0
servers:
  - url: https://api.langdock.com
    description: Production
security:
  - bearerAuth: []
paths:
  /prompts/v1/folders:
    get:
      tags:
        - Prompts
      summary: List prompt folders
      description: Returns prompt folders you can access in your workspace.
      operationId: listPromptFolders
      parameters:
        - name: limit
          in: query
          required: false
          schema:
            type: integer
            minimum: 1
            maximum: 250
            default: 50
          description: Number of folders to return.
        - name: cursor
          in: query
          required: false
          schema:
            type: string
            format: uuid
          description: Cursor from the previous response for pagination.
        - name: query
          in: query
          required: false
          schema:
            type: string
          description: Search query matched against folder name.
        - name: sharedWithWorkspace
          in: query
          required: false
          schema:
            type: string
            enum:
              - 'true'
              - 'false'
          description: Filter by workspace sharing.
      responses:
        '200':
          description: Prompt folders returned successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ListPromptFoldersResponse'
        '400':
          description: Invalid query parameter
        '401':
          description: Invalid or missing API key
        '403':
          description: Missing required scope or access
        '429':
          description: Rate limit exceeded
        '500':
          description: Internal server error
components:
  schemas:
    ListPromptFoldersResponse:
      type: object
      required:
        - folders
      properties:
        folders:
          type: array
          items:
            $ref: '#/components/schemas/PromptFolder'
        nextCursor:
          type: string
          format: uuid
          description: Cursor for the next page, if more results are available.
    PromptFolder:
      type: object
      required:
        - id
        - name
        - createdBy
        - sharedWithWorkspace
        - createdAt
        - updatedAt
      properties:
        id:
          type: string
          format: uuid
          description: Unique identifier for the prompt folder.
        name:
          type: string
          minLength: 2
          maxLength: 50
          description: Folder name.
        createdBy:
          type: string
          format: uuid
          description: User ID of the folder creator.
        sharedWithWorkspace:
          type: boolean
          description: Whether the folder is shared with the workspace.
        sharedWithGroupId:
          type: string
          format: uuid
          nullable: true
          description: Group ID the folder is shared with.
        createdAt:
          type: string
          format: date-time
          description: ISO 8601 timestamp for folder creation.
        updatedAt:
          type: string
          format: date-time
          description: ISO 8601 timestamp for the latest folder update.
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: API Key
      description: API key as Bearer token. Format "Bearer YOUR_API_KEY"

````