Ressourcen-Uploads

Lädt eine Datei zu einem KI-Provider hoch, der Uploads unterstützt. POST und PUT sind gleichwertig. Die Anfrage muss multipart/form-data sein.

POST /api/ai/resources

PUT /api/ai/resources

REQUEST-Parameter Werttyp Beschreibung
file file Multipart-Datei-Part. Erforderlich. Fehlt ein Part namens file, wird der erste Part mit Dateiname verwendet.
providerId oder provider string Provider-Auswahl per Query oder Formularfeld. Ohne Angabe wird der Standard-Provider verwendet.
name string Optionaler Ressourcenname. Fehlt er, werden Dateiname oder Part-Name verwendet.

Der gewählte Provider muss Upload unterstützen, sonst schlägt die Anfrage fehl. Unbekannte Provider liefern 404. Falsche Methoden liefern 405.

RESPONSE-Feld Werttyp Beschreibung
providerId string Für den Upload verwendeter Provider.
resourceId string Ressourcen-Identifier für spätere KI-Anfragen.

Beispielanfrage

# Request
POST /api/ai/resources?providerId=Primary-Provider HTTP/1.1
Host: helpdesk.example.com
Authorization: Bearer <access_token>
Content-Type: multipart/form-data; boundary=----boundary
 
------boundary
Content-Disposition: form-data; name="file"; filename="notes.txt"
Content-Type: text/plain
 
Example notes
------boundary--
 
# Response
HTTP/1.1 200 OK
Content-Type: application/json
 
{
  "providerId": "Primary Provider",
  "resourceId": "res_123"
}