QANATIX
API ReferenceInteractive ReferenceConnectors

Register a data connector

Register a pull connector (PostgreSQL, MySQL, MongoDB, Neo4j) to pull data on demand.

POST
/api/v1/connectors

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/connectors" \  -H "Content-Type: application/json" \  -d '{    "name": "string",    "connector_type": "string",    "vertical": "string",    "entity_type": "string",    "connection_config": {}  }'
null
{
  "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. Cross-encoder reranking for fine-grained precision on top candidates. - **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.

Delete a connector

API reference for Delete a connector