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

# Scheduled Tasks auflisten

> Liste Scheduled Tasks, die diesem Workspace-API-Key gehören, neueste zuerst

Gibt Scheduled Tasks zurück, die dieser Workspace-API-Key erstellt hat, neueste zuerst. Aufgaben eines anderen Keys fehlen. Gelöschte Aufgaben fehlen.

## Basis-URL

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

<Warning>
  **Dedicated Deployments**

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

## Benötigte Scopes

Dieser Endpoint braucht den Scope `AUTOMATION_API` (**Scheduled Tasks API**) auf einem Workspace-API-Key.

## Parameter

| Parameter | In    | Typ     | Pflicht | Beschreibung                                       |
| --------- | ----- | ------- | ------- | -------------------------------------------------- |
| `limit`   | Query | integer | Nein    | Seitengröße von 1 bis 250. Standard: 50.           |
| `cursor`  | Query | string  | Nein    | Task-UUID aus `nextCursor` der vorherigen Antwort. |

## Beispiel

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

async function listScheduledTasks(cursor) {
  const response = await axios.get(
    "https://api.langdock.com/automations/v1",
    {
      params: { limit: 50, cursor },
      headers: {
        Authorization: "Bearer YOUR_API_KEY"
      }
    }
  );

  console.log(response.data.automations);
  return response.data.nextCursor;
}

listScheduledTasks();
```

## Antwortformat

### Erfolgreiche Antwort (200 OK)

`nextCursor` ist nur da, wenn es eine weitere Seite gibt. Jede Aufgabe enthält `runCount`. Alle Felder stehen in der [Scheduled Tasks API Übersicht](/de/developer/scheduled-tasks-api/scheduled-tasks-overview).

```typescript theme={null}
{
  automations: Array<{
    id: string;
    createdAt: string;
    name: string;
    prompt: string;
    modelId: string | null;
    modelMode: "UNSET" | "EXPLICIT" | "AUTO";
    assistantId: string | null;
    taggedAssistantId: string | null;
    frequency:
      | "MANUAL"
      | "DAILY"
      | "WEEKDAYS"
      | "WEEKLY"
      | "MONTHLY"
      | "SELECTED_WEEKDAYS";
    timeOfDay: string | null;
    dayOfWeek: number | null;
    dayOfMonth: number | null;
    daysOfWeek: number[];
    timezone: string | null;
    active: boolean;
    lastRunAt: string | null;
    runCount: number;
    attachments: Array<{
      id: string;
      name: string;
      mimeType: string | null;
      type: string | null;
    }>;
    taggedIntegrationIds: string[];
    taggedKnowledgeFolderIds: string[];
    taggedWorkflowIds: string[];
    taggedSkillSlugs: string[];
  }>;
  nextCursor?: string;
}
```

## Fehlerbehandlung

| Statuscode | Beschreibung                                                                                               |
| ---------- | ---------------------------------------------------------------------------------------------------------- |
| 400        | Ungültiges `limit` oder `cursor`                                                                           |
| 401        | Ungültiger oder fehlender API-Key, oder der Key-User wurde nicht gefunden                                  |
| 403        | `AUTOMATION_API` fehlt, persönlicher API-Key, Scheduled Tasks deaktiviert, oder der Key hat keinen Zugriff |
| 405        | Methode nicht erlaubt                                                                                      |
| 429        | Rate Limit überschritten                                                                                   |
| 500        | Interner Serverfehler                                                                                      |

<Info>
  Langdock blockiert Anfragen aus Browser-Origins absichtlich, um deinen API-Key zu schützen und deine Anwendungen sicher zu halten. Mehr dazu findest du im Guide zu [API Key Best Practices](/de/admin/ai-adoption-and-rollout/best-practices/api-key-best-practices).
</Info>


## OpenAPI

````yaml GET /automations/v1
openapi: 3.0.0
info:
  title: Langdock API
  version: 3.0.0
servers:
  - url: https://api.langdock.com
    description: Production
security:
  - bearerAuth: []
paths:
  /automations/v1:
    get:
      tags:
        - Scheduled Tasks
      summary: List scheduled tasks
      description: Returns scheduled tasks created by this workspace API key, newest first.
      operationId: listScheduledTasks
      parameters:
        - name: limit
          in: query
          required: false
          schema:
            type: integer
            minimum: 1
            maximum: 250
            default: 50
          description: Number of scheduled tasks to return.
        - name: cursor
          in: query
          required: false
          schema:
            type: string
            format: uuid
          description: Task UUID from nextCursor in the previous response.
      responses:
        '200':
          description: >-
            Scheduled tasks returned successfully. nextCursor is present only
            when another page exists. Each task includes runCount.
        '400':
          description: Invalid limit or cursor
        '401':
          description: Invalid or missing API key, or the key user was not found
        '403':
          description: >-
            Missing AUTOMATION_API, a personal API key, Scheduled Tasks
            disabled, or the key has no access
        '405':
          description: Method not allowed
        '429':
          description: Rate limit exceeded
        '500':
          description: Internal server error
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: API Key
      description: API key as Bearer token. Format "Bearer YOUR_API_KEY"

````