QANATIX
API ReferenceInteractive ReferenceEntities

Bulk delete entities

Soft-delete multiple entities at once.

POST
/api/v1/entities/bulk-delete

Header Parameters

x-tenant-id?|
authorization?|

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

curl -X POST "https://loading/api/v1/entities/bulk-delete" \  -H "Content-Type: application/json" \  -d '{    "entity_ids": [      "497f6eca-6276-4993-bfeb-53cbbbba6f08"    ]  }'
{
  "archived": 0
}
{
  "detail": [
    {
      "loc": [
        "string"
      ],
      "msg": "string",
      "type": "string",
      "input": null,
      "ctx": {}
    }
  ]
}

Hybrid search (POST)

Search entities within a vertical using hybrid search (dense + sparse vectors + DBSF fusion). Supports natural language queries, keyword search, and identifier exact match (EAN, part numbers, DIN/ISO codes). **Search modes** (auto-detected from query): - **Identifier**: Exact payload match for EAN/GTIN, DIN/ISO codes, part numbers, SKUs. Score = 1.0. - **Hybrid**: Dense (semantic) + sparse (BM25/keyword) vector search with DBSF score fusion. BGE-M3 provider adds ColBERT late-interaction rescoring. - **Degraded**: Postgres full-text search fallback when Qdrant is unavailable. **Zero-result fallback chain**: If hybrid search returns no results, the system automatically (1) relaxes user filters, (2) falls back to dense-only search, (3) returns empty with metadata flag. **Filters**: Key-value params applied as Qdrant payload conditions. Conventions: `field=val` (exact), `field_min` (>=), `field_max` (<=), `field_gt` (>), `field_lt` (<). Tenant isolation and archived-entity exclusion are always enforced.

Bulk update entities

Partial update multiple entities at once. All provided fields are applied to all entities.