Skip to main content
POST
Upload an attachment
⚠️ 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. Der Upload-Attachment-Endpunkt wird von beiden APIs gemeinsam genutzt. Wenn du die veraltete Assistants API verwendest, siehe den Migrations-Guide.
Lade Dateien hoch, auf die in Agent-Konversationen über ihre Anhangs-IDs verwiesen werden kann.
Erfordert einen API-Schlüssel mit dem KNOWLEDGE_FOLDER_API Scope. Du kannst API-Schlüssel in deinen Workspace Einstellungen erstellen.

Anforderungsformat

Dieser Endpunkt akzeptiert multipart/form-data Anfragen mit einem einzelnen Datei-Upload.

Antwortformat

Die API gibt die Informationen zur hochgeladenen Datei zurück:

Beispiel

Fehlerbehandlung

Upload-Fehler

Ein Fehler bei der Validierung des Dateiinhalts gibt folgende Antwort zurück:

Attachment verwenden

Die hochgeladene Anhangs-ID kann in der Agent-API auf zwei Arten verwendet werden:
  1. Pro Nachricht (empfohlen): Füge die Anhangs-UUID in das metadata.attachments Array der Nachricht ein, wenn du die Completions API aufrufst
  2. Auf Agent-Ebene: Füge die Anhangs-UUID in das attachments Array ein, wenn du einen Agenten erstellst oder aktualisierst
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

multipart/form-data
file
file
erforderlich

The file to upload

Antwort

Successfully uploaded file

attachmentId
string<uuid>
erforderlich

Unique identifier for the uploaded attachment

Beispiel:

"550e8400-e29b-41d4-a716-446655440000"

file
object
erforderlich