Skip to main content
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/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.
Veröffentlicht den aktuellen Entwurf eines Agenten als neue Version. Dies entspricht dem Update-Button im Agenten-Editor: Eine veröffentlichte Version ist ein eingefrorener Snapshot des Entwurfs und wird zur aktiven Version, die Workspace-Mitglieder sehen. Änderungen über /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- oder editor-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 liefern 403.
  • Entwurfsänderungen erforderlich — Der Entwurf muss sich von der zuletzt veröffentlichten Version unterscheiden. Ein Aufruf ohne ausstehende Änderungen liefert 409 Conflict und 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

Authorization
string
header
erforderlich

API key as Bearer token. Format "Bearer YOUR_API_KEY"

Body

application/json
agentId
string<uuid>
erforderlich

UUID of the agent to publish

description
string

Optional change description shown in version history

Required string length: 1 - 500

Antwort

Agent published successfully

status
string
erforderlich
message
string
erforderlich
version
object
erforderlich