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

# Agenten auflisten

> Liste die Agenten deines Workspace mit Review- und Compliance-Status.

Liefert die Agenten deines Workspace, die zuletzt erstellten zuerst, mit Cursor-Pagination. Jeder Agent enthält Review-Status und Ergebnisse der Compliance-Regeln. Archivierte Agenten und Agenten-Templates sind nicht dabei. Ist **Private Ressourcen in Governance ausblenden** aktiv, fehlen auch Agenten, die mit niemandem sonst geteilt sind.

## Basis-URL

```
https://api.langdock.com/governance/v1/agents
```

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

## Voraussetzungen

* **API-Key** mit dem Scope `GOVERNANCE_API`
* **Governance aktivieren** ist an

Felder, Abfragen und Fehler stehen in der [Governance API Übersicht](https://docs.langdock.com/de/developer/governance-api/governance-overview.md).

## Parameter

| Parameter | Typ | Beschreibung |
| - | - | - |
| `limit` | integer | Agenten pro Seite. Mindestens 1, höchstens 100, Standard 50 |
| `cursor` | UUID | `nextCursor` der vorherigen Seite |
| `updatedSince` | datetime | Nur Agenten, deren `updatedAt` auf oder nach diesem Zeitpunkt liegt. ISO-8601-Zeitstempel mit Zeitzonen-Offset, zum Beispiel `2026-10-01T00:00:00Z` |
| `complianceStatus` | string | Kommagetrennt `not_checked`, `not_high_risk`, `potentially` oder `high_risk`. Wiederholte Query-Parameter gehen auch. Weglassen liefert jeden Status |

`updatedSince` folgt `updatedAt` des Agenten, nicht dem Zeitpunkt, zu dem eine Compliance-Regel fertig wurde. Wie du markierte Agenten abfragst, steht unter [Abfragen](https://docs.langdock.com/de/developer/governance-api/governance-overview.md#abfragen).

```bash theme={null}
curl "https://api.langdock.com/governance/v1/agents?complianceStatus=high_risk,potentially&updatedSince=2026-10-01T00:00:00Z&limit=50" \
  -H "Authorization: Bearer YOUR_API_KEY"
```

Die Antwort enthält `agents` und `nextCursor`. Der Filter `complianceStatus` greift vor dem Blättern, `nextCursor` setzt also in der gefilterten Liste fort. Gib `nextCursor` als `cursor` mit und behalte dieselben Filter. Ist `nextCursor` null, war das die letzte Seite.

```bash theme={null}
curl "https://api.langdock.com/governance/v1/agents?complianceStatus=high_risk,potentially&limit=50&cursor=2f1c7b9e-5d7a-4f2a-9d2e-5b2c0e8f1a3b" \
  -H "Authorization: Bearer YOUR_API_KEY"
```

## Rate Limits

Dieser Endpunkt erlaubt **500 Anfragen pro Minute** je Workspace und API-Key. Ein Token-Limit gibt es nicht. Darüber bekommst du `429 Too Many Requests`.

> [!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.