Assistant Files

Assistant Files API

Achtung

Diese API ist ein Premium-Feature und muss fuer deine Organisation freigeschaltet werden. Kontaktiere den Support, um Zugriff zu erhalten.

Authentifizierung

Diese API verwendet User API Keys. Diese koennen in den User-Settings erstellt werden und haben das Prefix sk_meingpt_.

curl -X GET "https://app.meingpt.com/api/assistant-files/v1/assistants/{assistantId}/files" \
  -H "Authorization: Bearer $MEINGPT_API_KEY"

Berechtigungen

Dateien auflisten / Metadaten abrufen: Erfordert VIEW, EDIT oder OWNER Berechtigung fuer den Assistenten
Dateien hochladen / ersetzen / loeschen: Erfordert EDIT oder OWNER Berechtigung fuer den Assistenten

Endpoints

gethttps://app.meingpt.com/api/assistant-files/v1/assistants/{assistantId}/files

Alle Dateien eines Assistenten auflisten

Gibt eine Liste aller Dateien zurueck, die in die Wissensbasis des angegebenen Assistenten hochgeladen wurden (inkl. Metadaten fuer Change Detection).

🔒 ApiKeyAuth

Parameter

Parameter	In	Typ	Beschreibung
Authorization*	header	string	API-Schlüssel zur Authentifizierung. Verwende das Format 'Bearer <Dein-API-Schlüssel>'.
assistantId*	path	string	Die AssistantId

Responses

200Liste der Dateien

Feld	Typ	Beschreibung
files*	Array<object>
count*	number
assistantId*	string

401Nicht autorisiert - API-Key fehlt oder ist ungueltig

Feld	Typ	Beschreibung
status	string
message	string

403Verboten - Feature nicht aktiviert oder keine Berechtigung

Feld	Typ	Beschreibung
status	string
message	string

404Assistent nicht gefunden

Feld	Typ	Beschreibung
status	string
message	string

posthttps://app.meingpt.com/api/assistant-files/v1/assistants/{assistantId}/files

Neue Datei zu einem Assistenten hochladen

Laedt eine Datei hoch und fuegt sie der Wissensbasis des Assistenten hinzu. Limit: max. 150MB pro Datei.

🔒 ApiKeyAuth

Parameter

Parameter	In	Typ	Beschreibung
Authorization*	header	string	API-Schlüssel zur Authentifizierung. Verwende das Format 'Bearer <Dein-API-Schlüssel>'.
assistantId*	path	string	Die AssistantId

Responses

200Datei erfolgreich hochgeladen

Feld	Typ	Beschreibung
success*	boolean
assistantId*	string
file*	object

401Nicht autorisiert - API-Key fehlt oder ist ungueltig

Feld	Typ	Beschreibung
status	string
message	string

403Verboten - erfordert EDIT oder OWNER Berechtigung

Feld	Typ	Beschreibung
status	string
message	string

404Assistent nicht gefunden

Feld	Typ	Beschreibung
status	string
message	string

gethttps://app.meingpt.com/api/assistant-files/v1/assistants/{assistantId}/files/{documentId}

Metadaten einer Datei abrufen

Gibt Metadaten zu einer Datei zurueck (z.B. fuer Change Detection).

🔒 ApiKeyAuth

Parameter

Parameter	In	Typ	Beschreibung
Authorization*	header	string	API-Schlüssel zur Authentifizierung. Verwende das Format 'Bearer <Dein-API-Schlüssel>'.
assistantId*	path	string	Die AssistantId
documentId*	path	string	Die DocumentId

Responses

200Datei-Metadaten

Feld	Typ	Beschreibung
id*	string
originalName*	string
mimeType*	string
size*	number
createdAt*	string
updatedAt	string
processingStatus	string
derivations*	Array<string>
assistantId*	string

401Nicht autorisiert - API-Key fehlt oder ist ungueltig

Feld	Typ	Beschreibung
status	string
message	string

403Verboten - Feature nicht aktiviert oder keine Berechtigung

Feld	Typ	Beschreibung
status	string
message	string

404Datei nicht gefunden

Feld	Typ	Beschreibung
status	string
message	string

puthttps://app.meingpt.com/api/assistant-files/v1/assistants/{assistantId}/files/{documentId}

Bestehende Datei ersetzen

Ersetzt eine bestehende Datei, indem eine neue Datei hochgeladen und das vorherige Dokument geloescht wird. Hinweis: Der Upload erhaelt eine neue id.

🔒 ApiKeyAuth

Parameter

Parameter	In	Typ	Beschreibung
Authorization*	header	string	API-Schlüssel zur Authentifizierung. Verwende das Format 'Bearer <Dein-API-Schlüssel>'.
assistantId*	path	string	Die AssistantId
documentId*	path	string	Die DocumentId, die ersetzt werden soll

Responses

200Datei erfolgreich ersetzt

Feld	Typ	Beschreibung
success*	boolean
assistantId*	string
replacedId*	string
originalId*	string
file*	object

401Nicht autorisiert - API-Key fehlt oder ist ungueltig

Feld	Typ	Beschreibung
status	string
message	string

403Verboten - erfordert EDIT oder OWNER Berechtigung

Feld	Typ	Beschreibung
status	string
message	string

404Datei oder Assistent nicht gefunden

Feld	Typ	Beschreibung
status	string
message	string

deletehttps://app.meingpt.com/api/assistant-files/v1/assistants/{assistantId}/files/{documentId}

Datei eines Assistenten loeschen

Loescht eine Datei dauerhaft aus der Wissensbasis des Assistenten.

🔒 ApiKeyAuth

Parameter

Parameter	In	Typ	Beschreibung
Authorization*	header	string	API-Schlüssel zur Authentifizierung. Verwende das Format 'Bearer <Dein-API-Schlüssel>'.
assistantId*	path	string	Die AssistantId
documentId*	path	string	Die DocumentId

Responses

200Datei erfolgreich geloescht

Feld	Typ	Beschreibung
success*	boolean
assistantId*	string
originalId*	string

401Nicht autorisiert - API-Key fehlt oder ist ungueltig

Feld	Typ	Beschreibung
status	string
message	string

403Verboten - erfordert EDIT oder OWNER Berechtigung

Feld	Typ	Beschreibung
status	string
message	string

404Datei oder Assistent nicht gefunden

Feld	Typ	Beschreibung
status	string
message	string

Hinweis

Beim Ersetzen einer Datei wird zuerst ein neues Dokument hochgeladen und anschliessend das alte geloescht. Der Upload erhaelt dabei eine neue id.

AssistantId finden

Gehe in den Bearbeitungsmodus deines Assistenten
In der URL findest du hinter /assistants/ die AssistantId

AssistantId im Assistant Bearbeitungsmodus

War diese Seite hilfreich?