# Qdrant (/integrations/qdrant)



{/* MANUAL-CONTENT-START:intro */}

Use [Qdrant](https://qdrant.tech) in Sim to upsert points, search for similar vectors with optional payload filters, and fetch points by ID. Points contain vectors and associated payload data; fetch and search options control which fields are returned.

{/* MANUAL-CONTENT-END */}

## Use the block [#usage-instructions]

Upsert, search, and fetch points.

## Actions [#actions]

### Qdrant Upsert Points [#qdrant-upsert-points]

Insert or update points in a Qdrant collection

#### Input [#input]

| Parameter | Type | Required | Description |
| - | - | - | - |
| `url` | string | Yes | Qdrant instance URL (e.g., [https://your-cluster.qdrant.io](https://your-cluster.qdrant.io)) |
| `apiKey` | string | No | Qdrant API key for authentication |
| `collection` | string | Yes | Collection name for upsert (e.g., "my\_collection") |
| `points` | array | Yes | Array of points to upsert |

#### Output [#output]

| Parameter | Type | Description |
| - | - | - |
| `status` | string | Operation status (ok, error) |
| `data` | object | Result data from the upsert operation |
| ↳ `operation_id` | number | Operation ID for async tracking |
| ↳ `status` | string | Operation status (acknowledged, completed) |

### Qdrant Search Vector [#qdrant-search-vector]

Search for similar vectors in a Qdrant collection

#### Input [#input-1]

| Parameter | Type | Required | Description |
| - | - | - | - |
| `url` | string | Yes | Qdrant instance URL (e.g., [https://your-cluster.qdrant.io](https://your-cluster.qdrant.io)) |
| `apiKey` | string | No | Qdrant API key for authentication |
| `collection` | string | Yes | Collection name to search (e.g., "my\_collection") |
| `vector` | array | Yes | Query vector for similarity search (e.g., \[0.1, 0.2, 0.3, ...]) |
| `limit` | number | No | Maximum number of results to return (e.g., 10) |
| `filter` | object | No | Qdrant filter object (e.g., \{"must": \[\{"key": "field", "match": \{"value": "val"}}]}) |
| `search_return_data` | string | No | Data to return from search |
| `with_payload` | boolean | No | Include payload in response |
| `with_vector` | boolean | No | Include vector in response |

#### Output [#output-1]

| Parameter | Type | Description |
| - | - | - |
| `status` | string | Operation status (ok, error) |
| `data` | array | Vector search results with ID, score, payload, and optional vector data |
| ↳ `id` | string | Point ID (integer or UUID string) |
| ↳ `version` | number | Point version number |
| ↳ `score` | number | Similarity score |
| ↳ `payload` | json | Point payload data (key-value pairs) |
| ↳ `vector` | json | Point vector(s) - single array or named vectors object |
| ↳ `shard_key` | string | Shard key for routing |
| ↳ `order_value` | number | Order value for sorting |

### Qdrant Fetch Points [#qdrant-fetch-points]

Fetch points by ID from a Qdrant collection

#### Input [#input-2]

| Parameter | Type | Required | Description |
| - | - | - | - |
| `url` | string | Yes | Qdrant instance URL (e.g., [https://your-cluster.qdrant.io](https://your-cluster.qdrant.io)) |
| `apiKey` | string | No | Qdrant API key for authentication |
| `collection` | string | Yes | Collection name to fetch from (e.g., "my\_collection") |
| `ids` | array | Yes | Array of point IDs to fetch (e.g., \["id1", "id2"] or \[1, 2]) |
| `fetch_return_data` | string | No | Data to return from fetch |
| `with_payload` | boolean | No | Include payload in response |
| `with_vector` | boolean | No | Include vector in response |

#### Output [#output-2]

| Parameter | Type | Description |
| - | - | - |
| `status` | string | Operation status (ok, error) |
| `data` | array | Fetched points with ID, payload, and optional vector data |
| ↳ `id` | string | Point ID (integer or UUID string) |
| ↳ `payload` | json | Point payload data (key-value pairs) |
| ↳ `vector` | json | Point vector(s) - single array or named vectors object |
| ↳ `shard_key` | string | Shard key for routing |
| ↳ `order_value` | number | Order value for sorting |