Publishes a draft agent as a new version
Agents API
Agent Veröffentlichen API
Veröffentliche einen Agenten-Entwurf als neue Version
POST
Publishes a draft agent as a new version
⚠️ Du nutzt unsere API in einem Dedicated Deployment? Ersetze einfach
api.langdock.com durch die Base URL deines Deployments: <deployment-url>/api/publicDies ist die neue Agents API mit nativer Vercel AI SDK Kompatibilität. Wenn du die veraltete Assistants API verwendest, siehe den Migrations-Guide.
/agent/v1/update wirken sich nur auf den Entwurf aus. Bis du publish aufrufst, sind diese Änderungen für Workspace-Mitglieder nicht sichtbar.
Anwendungsfälle
- Entwurfsänderungen über die Update-API in eine neue aktive Version überführen
- Änderungen programmatisch ausrollen als Teil einer CI/CD-Pipeline
- Neue Revision veröffentlichen mit optionaler Änderungsbeschreibung in der Versionshistorie
Request-Parameter
Beispiel
Antwort-Format
Erfolgreiche Antwort (200 OK)
Validierungsregeln
- Agenten-Zugriff — Der API-Schlüssel muss
owner- odereditor-Zugriff auf den Agenten haben (wie bei Update). - Workspace-Übereinstimmung — Der Agent muss zum selben Workspace gehören wie der API-Schlüssel.
- Nur Agenten — Projekte (
type=PROJECT) werden nicht unterstützt und liefern403. - Entwurfsänderungen erforderlich — Der Entwurf muss sich von der zuletzt veröffentlichten Version unterscheiden. Ein Aufruf ohne ausstehende Änderungen liefert
409 Conflictund spiegelt damit den deaktivierten “Update”-Button in der UI wider.
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
API key as Bearer token. Format "Bearer YOUR_API_KEY"
Body
application/json