# Documenten pushen vanuit jouw eigen systemen
Source: https://nordvec.com/nl/docs/guides/how-to/push-documents#push-één-document

## Push één document [#push-één-document]

`/documents/push` maakt het document aan, of werkt het bij wanneer een document met dezelfde `id` al bestaat in de gegevensbron.

```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` is jouw stabiele id voor het document binnen de gegevensbron. Het opnieuw pushen van dezelfde `id` werkt het bij; ongewijzigde inhoud wordt herkend aan de hash en niet twee keer geïndexeerd.
* `body.mimeType` is een van `text/plain`, `text/markdown`, `text/html`, `application/pdf`, of de Word-, Excel- en PowerPoint-typen (`.docx`, `.xlsx`, `.pptx`). Binaire inhoud wordt base64-gecodeerd verzonden.
* `sourceUrl` wordt de "spring naar bron"-link bij elke citering van het document. Laat het weg bij een her-push om de opgeslagen link te behouden, of stuur `null` om deze te wissen.
* `type` stelt het `content_type` van het document in, waarop zoeken en lijsten filteren.

Het hele requestbody is begrensd tot 1 MB, dus een groot bestand of een grote batch antwoordt met `413`; splits het.