Skip to main content
GET
Retrieves details of an existing agent
⚠️ Du nutzt unsere API in einem Dedicated Deployment? Ersetze einfach api.langdock.com durch die Base URL deines Deployments: <deployment-url>/api/public
Dies ist die neue Agents API mit nativer Vercel AI SDK Kompatibilität. Wenn du die veraltete Assistants API verwendest, siehe den Migrations-Guide.
Gibt die aktive (veröffentlichte) Version des Agenten zurück. Wenn der Agent noch nie veröffentlicht wurde, wird stattdessen der aktuelle Entwurf zurückgegeben.
Ruft die verfügbaren aktuellen Einstellungen und Details eines vorhandenen Agenten in deinem Workspace ab.
Erfordert einen API-Schlüssel mit dem AGENT_API Scope und Zugriff auf den Agenten, den du abrufen möchtest.

Query-Parameter

Beispiele

Einfacher Abruf

Validierungsregeln

Die API wendet folgende Validierungsregeln an:
  • Agent-Zugriff - Dein API-Schlüssel muss Zugriff auf den Agenten haben
  • Workspace-Übereinstimmung - Der Agent muss zum selben Workspace wie dein API-Schlüssel gehören

Antwortformat

Erfolgreiche Antwort (200 OK)

Fehlerbehandlung

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.

Autorisierungen

Authorization
string
header
erforderlich

API key as Bearer token. Format "Bearer YOUR_API_KEY"

Abfrageparameter

agentId
string<uuid>
erforderlich

Antwort

200 - application/json

Agent retrieved successfully

status
string
erforderlich
agent
object
erforderlich