---
title: "Changes to Upsert documents with BYO vectors"
method: POST
path: "/v1/namespaces/{namespace_id}/documents/upsert"
---

# Changes to Upsert documents with BYO vectors

`POST /v1/namespaces/{namespace_id}/documents/upsert`

> Every recorded change to this endpoint, newest first.

## Timeline

Changed in 4 of 32 revisions.

- **2026-08-21** `1c7f31821424` — 1 info
- **2026-08-20** `c768d4d28e4c` — 1 info
- **2026-08-18** `64c58b634192` — 9 info
- **2026-08-09** `5d4c905106b4` — 1 info

## Changes

- **2026-08-21** `1c7f31821424` — 1 info
  - added the new `signal` enum value to the request property `documents/items/source_type/anyOf[subschema #1]/`
- **2026-08-20** `c768d4d28e4c` — 1 info
  - added the optional property `dropped_payload_fields` to the response with the `200` status
- **2026-08-18** `64c58b634192` — 9 info
  - added the new optional request property `documents/items/content_hash`
  - added the new optional request property `documents/items/lineage_chain`
  - added the new optional request property `documents/items/lineage_path`
  - added the new optional request property `documents/items/root_bucket_id`
  - added the new optional request property `documents/items/root_object_id`
  - added the new optional request property `documents/items/source_collection_id`
  - added the new optional request property `documents/items/source_document_id`
  - added the new optional request property `documents/items/source_object_id`
  - added the new optional request property `documents/items/source_type`
- **2026-08-09** `5d4c905106b4` — 1 info
  - the endpoint scheme security `BearerAuth` was added to the API

---

[Operation](https://skmtc.dev/mixpeek/apis/mixpeek-api/docs/v1/namespaces/:namespace_id/documents/upsert/post.md) · [API](https://skmtc.dev/mixpeek/apis/mixpeek-api.md) · [Page](https://skmtc.dev/mixpeek/apis/mixpeek-api/changes/v1/namespaces/:namespace_id/documents/upsert/post)