# Dokumente aus deinen eigenen Systemen pushen
Source: https://nordvec.com/de/docs/guides/how-to/push-documents#ein-dokument-pushen

## Ein Dokument pushen [#ein-dokument-pushen]

`/documents/push` erstellt das Dokument oder aktualisiert es, wenn ein Dokument mit demselben `id` bereits in der Datenquelle existiert.

```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` ist deine stabile ID für das Dokument innerhalb der Datenquelle. Wenn du denselben `id` erneut übermittelst, wird das Dokument aktualisiert. Unveränderter Inhalt wird anhand seines Hash-Werts erkannt und nicht zweimal indexiert.
* `body.mimeType` ist einer der Typen `text/plain`, `text/markdown`, `text/html`,
  `application/pdf` oder die Word-, Excel- und PowerPoint-Typen (`.docx`, `.xlsx`,
  `.pptx`). Binärinhalte werden base64-kodiert gesendet.
* `sourceUrl` wird zum "Zur Quelle springen"-Link bei jeder Zitierung des Dokuments. Lasse das Feld bei einer erneuten Übermittlung weg, um den gespeicherten Link beizubehalten, oder sende `null`, um ihn zu löschen.
* `type` legt den `content_type` des Dokuments fest, nach dem in der Suche und Filterliste gefiltert wird.

Der gesamte Anfragebody ist auf 1 MB begrenzt, sodass eine große Datei oder ein großer Batch mit `413` antwortet; teile sie auf.