Reconfigure namespace Qdrant schema

Reconfigure the namespace’s Qdrant collection to include vectors from all deployed plugins.

When to use this: After deploying a new plugin to a namespace that already has data (points_count > 0). The auto-rebuild (Phase 1) only works on empty collections. For namespaces with existing data, use this endpoint to rebuild the schema, then re-trigger batches to re-ingest.

WARNING: This is destructive!

• All existing Qdrant points are deleted
• The collection is recreated with merged vector definitions
• You must re-trigger batches on each collection to re-populate data

Workflow:

1. Deploy your new plugin: POST /plugins/uploads/{id}/confirm
2. Deploy it: POST /plugins/{id}/deploy
3. Reconfigure: POST /plugins/reconfigure with {"confirm": true}
4. Re-trigger each collection listed in collections_to_reprocess

Response includes:

• vectors_added: New vector indexes added by the reconfigure
• vectors_total: All vector indexes in the reconfigured collection
• collections_to_reprocess: Collection IDs to re-trigger for data re-ingestion

POST /v1/namespaces/{namespace_id}/plugins/reconfigure

Reconfigure namespace Qdrant schema

cURL

curl --request POST \
  --url https://api.mixpeek.com/v1/namespaces/{namespace_id}/plugins/reconfigure \
  --header 'Content-Type: application/json' \
  --data '
{
  "confirm": true
}
'

200

reconfigured

{
  "namespace_id": "ns_abc123",
  "status": "reconfigured",
  "previous_points_count": 1500,
  "vectors_added": [
    "fashionsiglip_v1_embedding"
  ],
  "vectors_total": [
    "multilingual_e5_large_instruct_v1",
    "fashionsiglip_v1_embedding"
  ],
  "collections_to_reprocess": [
    "col_xxx",
    "col_yyy"
  ],
  "message": "Qdrant collection reconfigured with 1 new vector(s). 1500 points were deleted. Re-trigger batches on the listed collections to re-ingest data with the new vectors."
}

Headers

Authorization · string

REQUIRED: Bearer token authentication using your API key. Format: 'Bearer sk_xxxxxxxxxxxxx'. You can create API keys in the Mixpeek dashboard under Organization Settings.

Examples:

"Bearer YOUR_API_KEY"

"Bearer YOUR_STRIPE_API_KEY"

Path Parameters

namespace_id · string · required

Body

application/json

Request to reconfigure a namespace's Qdrant collection schema.

This is a destructive operation: it deletes and recreates the Qdrant collection with merged vector definitions from all deployed plugins. Existing data is lost and must be re-ingested by triggering batches on each collection.

confirm · boolean · required

Must be True to confirm this destructive operation. Existing Qdrant data will be deleted and must be re-ingested.

Response

200

application/json

Namespace reconfigured successfully

Response from reconfiguring a namespace's Qdrant collection.

namespace_id · string · required

The reconfigured namespace

status · string · required

Operation status: 'reconfigured' or 'no_changes_needed'

previous_points_count · integer · required

Number of Qdrant points that were in the collection before reconfigure

vectors_added · string[] · required

Names of new vector indexes added to the schema

vectors_total · string[] · required

All vector index names in the reconfigured collection

collections_to_reprocess · string[] · required

Collection IDs that need to be re-triggered to populate new vectors

message · string · required

Human-readable status message