Skip to main content
GET
[Deprecated] Retrieves details of an existing assistant
Ruft die verfügbaren aktuellen Einstellungen und Details eines vorhandenen Assistenten in deinem Workspace ab.
Erfordert einen API-Schlüssel mit dem AGENT_API Scope und Zugriff auf den Assistenten, den du abrufen möchtest.
Die Assistants API wird am 16. August eingestellt.Für neue Systeme empfehlen wir die Agents API. Die Agents API bietet native Vercel AI SDK Kompatibilität und entfernt benutzerdefinierte Transformationen.Siehe den Migrations-Guide für Details zu den Unterschieden.

Query-Parameter

Beispiele

Einfacher Abruf

Validierungsregeln

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

Antwortformat

Erfolgreiche Antwort (200 OK)

Fehlerbehandlung

Migration zur Agents API

Die neue Agents API bietet verbesserte Kompatibilität mit modernen AI SDKs. Der Get-Endpunkt hat ähnliche Funktionalität mit aktualisierten Parameternamen. Siehe den entsprechenden Endpunkt in der Agents API:
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

assistantId
string<uuid>
erforderlich

UUID of the agent to retrieve

Antwort

Assistant details retrieved successfully

status
enum<string>
erforderlich
Verfügbare Optionen:
success
assistant
object
erforderlich