Passer au contenu principal
POST
/
agent-sessions
/
{session_id}
/
upload
Téléverser et lier un document
import requests

url = "https://app.ubik-agent.com/api/v1/agent-sessions/{session_id}/upload"

files = { "file": ("example-file", open("example-file", "rb")) }
payload = { "api_metadata": "<string>" }
headers = {"X-API-KEY": "<api-key>"}

response = requests.post(url, data=payload, files=files, headers=headers)

print(response.text)
{
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "name": "<string>",
  "status": "<string>",
  "created_at": "2023-11-07T05:31:56Z",
  "updated_at": "2023-11-07T05:31:56Z",
  "file_type": "<string>",
  "processing_pipeline": "<string>",
  "error_message": "<string>",
  "api_metadata": {},
  "file_name": "<string>",
  "markdown_content": "<string>"
}

Autorisations

X-API-KEY
string
header
requis

En-têtes

X-End-User-ID
string | null

Paramètres de chemin

session_id
string<uuid>
requis

Corps

multipart/form-data
file
file
requis
api_metadata
string | null

Métadonnées API personnalisées (chaîne JSON).

Réponse

Successful Response

id
string<uuid>
requis

L'identifiant unique du document.

name
string
requis

Le nom d'affichage du document.

status
string
requis

Le statut de traitement actuel du document.

created_at
string<date-time>
requis

L'horodatage de la création du document.

updated_at
string<date-time>
requis

L'horodatage de la dernière mise à jour du document.

file_type
string | null

Le type MIME du fichier du document.

processing_pipeline
string | null

Le nom du pipeline de traitement utilisé pour ce document.

error_message
string | null

Si le traitement a échoué, ce champ contiendra le message d'erreur.

api_metadata
Api Metadata · object

Métadonnées API personnalisées résolues pour l'utilisateur actuel. Utile pour récupérer des références externes stockées (par exemple {'internal_app_ref': 'REF-123'}). Note : Cette valeur est résolue en fonction de l'external_user_id de la requête. Un document partagé globalement mais aussi limité à un utilisateur spécifique peut renvoyer des métadonnées différentes selon qui demande.

file_name
string | null

Le nom de fichier original du document.

markdown_content
string | null

Le contenu complet du document converti au format Markdown.