# Poussez des documents depuis vos propres systèmes
Source: https://nordvec.com/fr/docs/guides/how-to/push-documents#pousser-un-document

## Pousser un document [#pousser-un-document]

`/documents/push` crée le document, ou le met à jour lorsqu'un document avec le même `id` existe déjà dans la source de données.

```bash
curl https://nordvec.com/api/v1/documents/push \
  -H "Authorization: Bearer $NORDVEC_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: page-4711-2026-09-28" \
  -d '{
    "tenantId": "YOUR_WORKSPACE_ID",
    "document": {
      "id": "page-4711",
      "title": "Travel expense policy",
      "datasource": "confluence-export",
      "body": { "mimeType": "text/markdown", "content": "# Travel expenses\n..." },
      "permissions": {},
      "sourceUrl": "https://wiki.example.com/pages/4711",
      "type": "policy"
    }
  }'
```

```json
{ "documentId": "page-4711", "status": "queued", "updated": false }
```

* `id` est votre identifiant stable pour le document au sein de la source de données. Pousser le même `id` à nouveau le met à jour ; un contenu inchangé est reconnu par son hachage et n'est pas indexé deux fois.
* `body.mimeType` est l'un des types suivants : `text/plain`, `text/markdown`, `text/html`, `application/pdf`, ou les types Word, Excel et PowerPoint (`.docx`, `.xlsx`, `.pptx`). Le contenu binaire est envoyé encodé en base64.
* `sourceUrl` devient le lien « sauter à la source » sur chaque citation du document. Omettez-le lors d'une nouvelle poussée pour conserver celui déjà stocké, ou envoyez `null` pour le supprimer.
* `type` définit le `content_type` du document, sur lequel la recherche et les filtres de liste s'appuient.

Le corps de la requête entier est limité à 1 Mo, donc un fichier volumineux ou un grand lot répond `413` ; divisez-le.