Upsert

async upsert({
    items?: VectorItem[],                            // Shape 1
    ids?: string[],                                  // Shape 2
    vectors?: number[][] | Float32Array,             // Shape 2
    metadata?: (Record<string, unknown> | null)[],   // Shape 2, optional
    contents?: (string | null)[],                    // Shape 2, optional
}): Promise<UpsertResponse>

const result = await index.upsert({
    items: [
        { id: 'doc1', vector: [0.1, 0.2, 0.3, 0.4], contents: 'First document' },
        { id: 'doc2', vector: [0.5, 0.6, 0.7, 0.8], metadata: { category: 'news' } },
    ],
});
console.log(result);
// Output: { status: 'success', message: 'Upserted 2 vectors' }

await index.upsert({
    ids: ['vec1', 'vec2', 'vec3'],
    vectors: [
        [0.1, 0.2, 0.3, 0.4],
        [0.5, 0.6, 0.7, 0.8],
        [0.9, 1.0, 1.1, 1.2],
    ],
    metadata: [{ category: 'news' }, { category: 'research' }, null],
    contents: ['First body', 'Second body', null],
});

const dim = 4;
const ids = ['vec4', 'vec5', 'vec6'];

// All vectors back to back: ids.length * dim values
const vectors = new Float32Array(ids.length * dim).map(() => Math.random());

await index.upsert({ ids, vectors });

await index.upsert({ items: [{ id: 'doc1', vector: [0.1, 0.2, 0.3, 0.4], metadata: { version: 1 } }] });

// Same ID: replaces the vector, contents, and metadata
await index.upsert({ items: [{ id: 'doc1', vector: [0.2, 0.3, 0.4, 0.5], metadata: { version: 2 } }] });

const [item] = await index.get({ ids: ['doc1'], include: ['metadata'] });
console.log(item.metadata);
// Output: { version: 2 }