Skip to main content
The Upserts page shows all the data upload operations you’ve performed in your Vectorify project. An upsert is a single operation that creates or updates multiple items in your knowledge base at once.
Vectorify Upserts 2025 07 06 Pn

​
What you’ll see

When you navigate to the Upserts page, you’ll find a table displaying your upload operations with five main columns:
  • Collection - Which data group does this upsert target
  • Chunk size - How the data was split for processing
  • Status - Current state of the upload (Pending, Processing, Completed, etc.)
  • Started - When the upload operation began
  • Completed - When the upload finished processing

​
Understanding upsert operations

Each upsert represents a batch upload of data to your project. The system processes your data through several stages:
  • Pending - Upsert is queued and waiting to start
  • Queued - Operation is in the processing queue
  • Processing - Data is being converted and stored
  • Completed - All items have been successfully processed
  • Failed - Something went wrong during processing

​
How upserts work behind the scenes

When you create an upsert, the system handles complex processing automatically:
  • Tracks which collection receives the data
  • Manages the AI service provider
  • Monitors processing attempts and error handling
  • Records timing information for performance tracking

​
Creating new upserts

You can create upserts through the API, which accepts your data items along with metadata and tenant information.

​
Accessing your upserts

You can view your upserts in two ways:
  1. Web Interface - Navigate using the sidebar menu
  2. API Access - Programmatically retrieve upserts using REST endpoints

​
Notes

If you haven’t performed any upserts yet, you’ll see an empty state message encouraging you to create your first upsert. Each upsert can process up to 90 items at once, and Vectorify automatically handles chunking, embeddings, vector processing, and a lot more in the background.
⌘I