meinGPT LogomeinGPT Docs
WebsitePlatform Login
User GuidePrompting GuideAdmin GuideRollout GuideDatenschutz & SicherheitIntegrationenAPI

Assistant Files

Assistant Files API

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

GET/assistant-files/v1/assistants/{assistantId}/files

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

Authorization

ApiKeyAuth
Authorization<token>

API-Schlüssel zur Authentifizierung. Verwende das Format 'Bearer <Dein-API-Schlüssel>'.

In: header

Path Parameters

assistantId*string

Die AssistantId

Header Parameters

Authorization*string

API-Schlüssel zur Authentifizierung. Verwende das Format 'Bearer <Dein-API-Schlüssel>'.

Response Body

application/json

application/json

application/json

application/json

curl -X GET "https://app.meingpt.com/api/assistant-files/v1/assistants/string/files" \  -H "Authorization: Bearer sk_meingpt_..."
{
  "files": [
    {
      "id": "string",
      "originalName": "string",
      "mimeType": "string",
      "size": 0,
      "createdAt": "string",
      "updatedAt": "string"
    }
  ],
  "count": 0,
  "assistantId": "string"
}
{
  "status": "error",
  "message": "string"
}
{
  "status": "error",
  "message": "string"
}
{
  "status": "error",
  "message": "string"
}
POST/assistant-files/v1/assistants/{assistantId}/files

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

Authorization

ApiKeyAuth
Authorization<token>

API-Schlüssel zur Authentifizierung. Verwende das Format 'Bearer <Dein-API-Schlüssel>'.

In: header

Path Parameters

assistantId*string

Die AssistantId

Header Parameters

Authorization*string

API-Schlüssel zur Authentifizierung. Verwende das Format 'Bearer <Dein-API-Schlüssel>'.

Request Body

multipart/form-data

file*file

Datei-Upload (max. 150MB)

Formatbinary

Response Body

application/json

application/json

application/json

application/json

curl -X POST "https://app.meingpt.com/api/assistant-files/v1/assistants/string/files" \  -H "Authorization: Bearer sk_meingpt_..." \  -F file="string"
{
  "success": true,
  "assistantId": "string",
  "file": {
    "id": "string",
    "originalName": "string",
    "size": 0,
    "mimeType": "string",
    "uploadedAt": "string"
  }
}
{
  "status": "error",
  "message": "string"
}
{
  "status": "error",
  "message": "string"
}
{
  "status": "error",
  "message": "string"
}
GET/assistant-files/v1/assistants/{assistantId}/files/{documentId}

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

Authorization

ApiKeyAuth
Authorization<token>

API-Schlüssel zur Authentifizierung. Verwende das Format 'Bearer <Dein-API-Schlüssel>'.

In: header

Path Parameters

assistantId*string

Die AssistantId

documentId*string

Die DocumentId

Header Parameters

Authorization*string

API-Schlüssel zur Authentifizierung. Verwende das Format 'Bearer <Dein-API-Schlüssel>'.

Response Body

application/json

application/json

application/json

application/json

curl -X GET "https://app.meingpt.com/api/assistant-files/v1/assistants/string/files/string" \  -H "Authorization: Bearer sk_meingpt_..."
{
  "id": "string",
  "originalName": "string",
  "mimeType": "string",
  "size": 0,
  "createdAt": "string",
  "updatedAt": "string",
  "processingStatus": "string",
  "derivations": [
    "string"
  ],
  "assistantId": "string"
}
{
  "status": "error",
  "message": "string"
}
{
  "status": "error",
  "message": "string"
}
{
  "status": "error",
  "message": "string"
}
PUT/assistant-files/v1/assistants/{assistantId}/files/{documentId}

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

Authorization

ApiKeyAuth
Authorization<token>

API-Schlüssel zur Authentifizierung. Verwende das Format 'Bearer <Dein-API-Schlüssel>'.

In: header

Path Parameters

assistantId*string

Die AssistantId

documentId*string

Die DocumentId, die ersetzt werden soll

Header Parameters

Authorization*string

API-Schlüssel zur Authentifizierung. Verwende das Format 'Bearer <Dein-API-Schlüssel>'.

Request Body

multipart/form-data

file*file
Formatbinary

Response Body

application/json

application/json

application/json

application/json

curl -X PUT "https://app.meingpt.com/api/assistant-files/v1/assistants/string/files/string" \  -H "Authorization: Bearer sk_meingpt_..." \  -F file="string"
{
  "success": true,
  "assistantId": "string",
  "replacedId": "string",
  "originalId": "string",
  "file": {
    "id": "string",
    "originalName": "string",
    "size": 0,
    "mimeType": "string",
    "uploadedAt": "string"
  }
}
{
  "status": "error",
  "message": "string"
}
{
  "status": "error",
  "message": "string"
}
{
  "status": "error",
  "message": "string"
}
DELETE/assistant-files/v1/assistants/{assistantId}/files/{documentId}

Loescht eine Datei dauerhaft aus der Wissensbasis des Assistenten.

Authorization

ApiKeyAuth
Authorization<token>

API-Schlüssel zur Authentifizierung. Verwende das Format 'Bearer <Dein-API-Schlüssel>'.

In: header

Path Parameters

assistantId*string

Die AssistantId

documentId*string

Die DocumentId

Header Parameters

Authorization*string

API-Schlüssel zur Authentifizierung. Verwende das Format 'Bearer <Dein-API-Schlüssel>'.

Response Body

application/json

application/json

application/json

application/json

curl -X DELETE "https://app.meingpt.com/api/assistant-files/v1/assistants/string/files/string" \  -H "Authorization: Bearer sk_meingpt_..."
{
  "success": true,
  "assistantId": "string",
  "originalId": "string"
}
{
  "status": "error",
  "message": "string"
}
{
  "status": "error",
  "message": "string"
}
{
  "status": "error",
  "message": "string"
}

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

AssistantId finden

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

AssistantId im Assistant Bearbeitungsmodus

Assistants

Vorherige Seite

Workflows

Nächste Seite

Auf dieser Seite

Assistant Files APIAuthentifizierungBerechtigungenEndpointsAssistantId finden