Update Embeddings

Update existing embeddings with new vector representations.

This endpoint allows you to modify embeddings that are already stored in your knowledge base. Provide updated vector representations for specific chunks of content, identified by their chunk IDs.

The system will replace the existing embeddings with your new ones, ensuring that similarity searches reflect the most current vector representations. Use this when you need to update embeddings due to model improvements or content changes.

Hit the Try it button to try this API now in our playground. It’s the best way to check the full request and response in one place, customize your parameters, and generate ready-to-use code snippets.

Examples

API Request

curl --request PATCH \
  --url 'https://api.usecortex.ai/upload/update_embeddings?tenant_id=tenant_1234&sub_tenant_id=sub_tenant_4567' \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "embeddings": {
    "CortexEmbeddings123_0": [
      0.123413,
      0.655367,
      0.987654,
      0.123456,
      0.789012
    ],
    "CortexEmbeddings123_1": [
      0.123413,
      0.655367,
      0.987654,
      0.123456,
      0.789012
    ]
  }
}'

Requirements

• Maximum dimensions: 2000 rows × 3024 columns; i.e. 2000 chunks with a maximum dimension of 3024
• Format: Dictionary with chunk IDs as keys and embedding arrays as values. These chunk IDs should match the ones that you got on inserting the embeddings.
• Batch constraint: All chunk IDs must belong to the same batch/source
• Chunk ID format: Must be valid strings in format {batch_id}_{index}
• Consistency: All embedding vectors must have the same dimension
• Values: All embedding values must be numeric (int or float)

Error Responses

All endpoints return consistent error responses following the standard format. For detailed error information, see our Error Responses documentation.

Authorizations

Authorization · string · header · required

Query Parameters

tenant_id · string · required

Example:

sub_tenant_id · string · default: ""

Example:

Body

application/json

embeddings · object

Show child attributes

Example:

Response

200

application/json

file_id · string · required

Example:

message · string · required

success · boolean · default: true

Example: