> ## 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.

# Prompts auflisten

> Rufe Prompts in deinem Workspace ab

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

## Basis-URL

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

<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 Prompts. Standard: `50`. Maximum: `250`. |
| `cursor`              | string  | Nein         | Cursor aus der vorherigen Antwort für die Pagination.                |
| `query`               | string  | Nein         | Suchanfrage, die gegen Titel und Inhalt des Prompts geprüft wird.    |
| `promptFolderId`      | string  | Nein         | Nach Prompt-Ordner-UUID filtern.                                     |
| `sharedWithWorkspace` | string  | Nein         | Nach Workspace-Freigabe filtern. Erlaubte Werte: `true`, `false`.    |

## Beispiel

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

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

  console.log("Prompts:", response.data.prompts);
  return response.data.nextCursor;
}

listPrompts();
```

## Antwortformat

### Erfolgsantwort (200 OK)

```typescript theme={null}
{
  prompts: Array<{
    id: string;
    title: string;
    prompt: string;
    createdBy: string | null;
    promptFolderId: string | null;
    sharedWithWorkspace: boolean;
    createdAt: string | null;
    updatedAt: string | null;
  }>;
  nextCursor?: string;
}
```

## Beispielantwort

```json theme={null}
{
  "prompts": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "title": "Support Reply",
      "prompt": "Write a concise customer reply. Include the next best action.",
      "createdBy": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
      "promptFolderId": null,
      "sharedWithWorkspace": true,
      "createdAt": "2026-07-28T10:30:00.000Z",
      "updatedAt": "2026-07-28T10:30:00.000Z"
    }
  ],
  "nextCursor": "550e8400-e29b-41d4-a716-446655440000"
}
```

## 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
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:
    get:
      tags:
        - Prompts
      summary: List prompts
      description: Returns prompts you can access in your workspace.
      operationId: listPrompts
      parameters:
        - name: limit
          in: query
          required: false
          schema:
            type: integer
            minimum: 1
            maximum: 250
            default: 50
          description: Number of prompts 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 prompt title and content.
        - name: promptFolderId
          in: query
          required: false
          schema:
            type: string
            format: uuid
          description: Filter by prompt folder UUID.
        - name: sharedWithWorkspace
          in: query
          required: false
          schema:
            type: string
            enum:
              - 'true'
              - 'false'
          description: Filter by workspace sharing.
      responses:
        '200':
          description: Prompts returned successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ListPromptsResponse'
        '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:
    ListPromptsResponse:
      type: object
      required:
        - prompts
      properties:
        prompts:
          type: array
          items:
            $ref: '#/components/schemas/Prompt'
        nextCursor:
          type: string
          format: uuid
          description: Cursor for the next page, if more results are available.
    Prompt:
      type: object
      required:
        - id
        - title
        - prompt
        - sharedWithWorkspace
      properties:
        id:
          type: string
          format: uuid
          description: Unique identifier for the prompt.
        title:
          type: string
          minLength: 2
          maxLength: 100
          description: Prompt title.
        prompt:
          type: string
          minLength: 2
          maxLength: 120000
          description: Prompt content.
        createdBy:
          type: string
          format: uuid
          nullable: true
          description: User ID of the prompt creator.
        promptFolderId:
          type: string
          format: uuid
          nullable: true
          description: Folder ID the prompt is assigned to.
        sharedWithWorkspace:
          type: boolean
          description: Whether the prompt is shared with the workspace.
        createdAt:
          type: string
          format: date-time
          nullable: true
          description: ISO 8601 timestamp for prompt creation.
        updatedAt:
          type: string
          format: date-time
          nullable: true
          description: ISO 8601 timestamp for the latest prompt update.
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: API Key
      description: API key as Bearer token. Format "Bearer YOUR_API_KEY"

````