OramaSearch Inc. LogoOramaCore
APIs Reference

Upsert Documents

APIs to update documents into an OramaCore collection.

APIs

OramaCore updates are actually upserts. This means that if a document with the same ID already exists, it will be updated. Otherwise, a new document will be created.

API Key type: write_api_key. Do not expose it to the public.

Once you have a collection with at least one index and some documents in it, you can start updating documents using the following API:

curl -X POST \
  http://localhost:8080/v1/collections/{COLLECTION_ID}/indexes/{INDEX_ID}/insert \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer <write_api_key>' \
  -d '[{
    "id": "<DOCUMENT_ID>",
    "title": "My upserted document",
    "content": "This is the content of my first upserted document."
  }]'

Just like during insertion, at upsert-time OramaCore will automatically generate generate text embeddings for the document in real-time, allowing you to perform full-text, hybrid, and vector search immediately.

On this page