# Lähetä dokumentteja omista järjestelmistäsi
Source: https://nordvec.com/fi/docs/guides/how-to/push-documents#työnnä-yksi-dokumentti

## Työnnä yksi dokumentti [#työnnä-yksi-dokumentti]

`/documents/push` luo dokumentin tai päivittää sen, jos dokumentti samalla `id`-tunnuksella on jo olemassa tietolähteessä.

```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` on vakaa tunnuksesi dokumentille tietolähteen sisällä. Saman `id`-tunnuksen työntäminen uudelleen päivittää dokumentin. Muuttumaton sisältö tunnistetaan tiivisteensä perusteella eikä sitä indeksoida kahdesti.
* `body.mimeType` on yksi `text/plain`, `text/markdown`, `text/html`, `application/pdf` tai Wordin, Excelin ja PowerPointin (`.docx`, `.xlsx`, `.pptx`) tyyppejä. Binäärisisältö lähetetään base64-koodattuna.
* `sourceUrl` tulee "siirry lähteeseen" -linkiksi jokaisessa dokumentin sitaatissa. Jätä se pois uudelleentyönnössä säilyttääksesi tallennetun linkin tai lähetä `null` tyhjentääksesi sen.
* `type` asettaa dokumentin `content_type`, jota haun ja listan suodattimet käyttävät.

Koko pyynnön runko on rajoitettu 1 Mt:n kokoon, joten suuri tiedosto tai iso erä vastaa `413`-virheellä. Jaa se osiin.