Skip to main content
POST
Upload an attachment
Die Assistants API wird am 16. August eingestellt.Für neue Systeme empfehlen wir die Agents API. Der Upload-Attachment-Endpunkt bleibt gleich, aber du solltest die Agents API Dokumentation referenzieren.Siehe den Migrations-Guide für Details zu den Unterschieden.
Lade Dateien hoch, auf die in Assistenten-Konversationen über ihre Anhangs-IDs verwiesen werden kann.
Um die API zu nutzen, benötigst du einen API-Schlüssel. 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 Assistant-API verwendet werden, indem du sie in das attachmentIds Array entweder auf Assistenten-Ebene oder Nachrichtenebene aufnimmst.

Migration zur Agents API

Der Upload-Attachment-Endpunkt bleibt in beiden APIs gleich. Für neue Systeme verwende die Agents API Dokumentation:
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