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

# Agent List API

> Agenten auflisten, die mit diesem API-Schlüssel geteilt sind

Liste die Agenten auf, die mit diesem API-Schlüssel zum Aufrufen geteilt sind. Die Antwort enthält nicht jeden Agenten im Workspace.

> [!NOTE]
>
> Deaktivierte Agenten sind mit `disabled: true` enthalten, aber [Chat-Completions](https://docs.langdock.com/de/developer/agents-api/agent.md) lehnen sie mit `403` und dem Code `ASSISTANT_DISABLED` ab, bis sie [wieder aktiviert](https://docs.langdock.com/de/developer/agents-api/agent-disable.md) werden.

## Bevor du startest

* **API-Key-Scope**: Erfordert den Scope **Agenten lesen** oder den bisherigen Scope **Agenten-API (voller Zugriff)**.
* **Veraltete Assistants API**: Dies ist die neue Agents API mit nativer Vercel AI SDK Kompatibilität. Wenn du die veraltete Assistants API verwendest, siehe den [Migrations-Guide](https://docs.langdock.com/de/developer/agents-api/assistant-to-agent-migration.md).

## Basis-URL

```
https://api.langdock.com/agent/v1/list
```

> [!WARNING]
>
> **Dedicated Deployments**
>
> Ersetze `api.langdock.com` durch `<your-deployment-url>/api/public` in allen Anfragen.

## Parameter

| Parameter | Typ | Erforderlich | Beschreibung |
| - | - | - | - |
| `limit` | integer | Nein | Seitengröße von 1 bis 250. Standard ist 50. |
| `cursor` | string | Nein | Agenten-ID aus dem `nextCursor` der vorherigen Seite. |

## Beispiele

### Erste Seite

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

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

  console.log("Agents:", response.data.agents);
}
```

## Validierungsregeln

Die API erzwingt die folgenden Validierungsregeln:

* **API-Schlüssel-Zugriff**: Die Liste enthält nur Agenten, die mit diesem API-Schlüssel zum Aufrufen geteilt sind
* **Workspace**: Agenten müssen zum selben Workspace gehören wie dein API-Schlüssel
* **Ausgelassene Agenten**: Gelöschte und archivierte Agenten fehlen. Projekte sind nicht enthalten. Deaktivierte Agenten bleiben in der Liste, mit `disabled` auf `true`. Du kannst erst wieder mit ihnen chatten, wenn sie wieder aktiviert sind

Die Agenten sind nach Erstellungszeit sortiert, die neuesten zuerst.

Name, Beschreibung, Emoji, Modell und Input-Typ kommen aus der zuletzt veröffentlichten Version. Wenn der Agent noch nie veröffentlicht wurde, kommen diese Felder aus dem Entwurf. Im Auto-Modus ist `model` `auto`.

Jeder Eintrag enthält weniger Felder als [Agenten-Details abrufen](https://docs.langdock.com/de/developer/agents-api/agent-get.md). `owner` ist der aktuelle Besitzer, solange dieser Nutzer noch eine aktive Mitgliedschaft im Workspace hat. Gibt es mehrere Besitzer, ist es der zuletzt vergebene, der noch aktives Mitglied ist. Der Wert ist `null`, wenn kein verbleibender Besitzer ein aktives Mitglied ist.

`nextCursor` ist nur enthalten, wenn eine weitere Seite existiert. Sende ihn als `cursor`, um die nächste Seite zu laden. Ein gültiger UUID-Cursor, der zu keinem Agenten passt, liefert `200` mit einem leeren `agents`-Array.

## Antwortformat

### Erfolgsantwort (200 OK)

```typescript theme={null}
{
  agents: Array<{
    id: string;
    name: string | null;
    description: string | null;
    emojiIcon: string | null;
    model: string | null;
    inputType: "PROMPT" | "STRUCTURED" | "INTEGRATION" | "SCHEDULED" | "WEBHOOK";
    owner: {
      id: string;
      name: string | null;
      email: string;
    } | null;
    disabled: boolean;
    createdAt: string | null;
    updatedAt: string | null;
  }>;
  nextCursor?: string;
}
```

## Fehlerbehandlung

```typescript theme={null}
try {
  const response = await axios.get('https://api.langdock.com/agent/v1/list', ...);
} catch (error) {
  if (error.response) {
    switch (error.response.status) {
      case 400:
        console.error('Limit nicht zwischen 1 und 250, keine ganze Zahl oder Cursor ist keine UUID');
        break;
      case 401:
        console.error('Ungültiger oder fehlender API-Schlüssel');
        break;
      case 403:
        console.error('API-Schlüssel hat nicht den Scope Agenten lesen oder Agenten-API (voller Zugriff)');
        break;
      case 500:
        console.error('Server-Fehler');
        break;
    }
  }
}
```

> [!NOTE]
>
> 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](https://docs.langdock.com/de/admin/ai-adoption-and-rollout/best-practices/api-key-best-practices.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.