How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Qdrant Points API

Float-point vectors with payload.

Qdrant Points API is one of 9 APIs that Qdrant publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Points. The published artifact set on APIs.io includes an OpenAPI specification and API documentation.

This API exposes 14 operations across 12 paths, and defines 107 schemas. It is described by OpenAPI 3.2.0, at version master.

Requests are made against a single base URL, {protocol}://{hostname}:{port}.

14 operations 12 paths 107 schemas 1 GET10 POST3 PUT

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.2.0
API Version
master
Server
{protocol}://{hostname}:{port}
Authentication
API Key, HTTP Bearer
License
Resource Areas
1

Authentication & Security 2

Qdrant Points API declares 2 security schemes for authenticating requests. An API key is passed in the header as api-key (api-key). It accepts HTTP bearer tokens (bearerAuth). By default, every request must be authenticated, though some operations may also be called without credentials.

  • api-key — Authorization key, either read-write or read-only

Paths & Operations 14

Across 12 paths, the API surfaces 14 operations — 1 GET, 10 POST, 3 PUT. Each is listed below with its method, path, parameters, and response codes.

Points 14

Float-point vectors with payload.

GET
/collections/{collection_name}/points/{id}
Get point
get_point 3 params → default4XX200
POST
/collections/{collection_name}/points
Get points
get_points 3 params body → default4XX200
PUT
/collections/{collection_name}/points
Upsert points
upsert_points 4 params body → default4XX200
POST
/collections/{collection_name}/points/delete
Delete points
delete_points 4 params body → default4XX200
PUT
/collections/{collection_name}/points/vectors
Update vectors
update_vectors 4 params body → default4XX200
POST
/collections/{collection_name}/points/vectors/delete
Delete vectors
delete_vectors 4 params body → default4XX200
POST
/collections/{collection_name}/points/payload
Set payload
set_payload 4 params body → default4XX200
PUT
/collections/{collection_name}/points/payload
Overwrite payload
overwrite_payload 4 params body → default4XX200
POST
/collections/{collection_name}/points/payload/delete
Delete payload
delete_payload 4 params body → default4XX200
POST
/collections/{collection_name}/points/payload/clear
Clear payload
clear_payload 4 params body → default4XX200
POST
/collections/{collection_name}/points/batch
Batch update points
batch_update 4 params body → default4XX200
POST
/collections/{collection_name}/points/scroll
Scroll points
scroll_points 3 params body → default4XX200
POST
/collections/{collection_name}/points/count
Count points
count_points 3 params body → default4XX200
POST
/collections/{collection_name}/facet
Facet a payload key with a given filter.
facet 3 params body → default4XX200

Schemas 107

The contract defines 107 schemas that model the data the API accepts and returns. The most detailed are Bm25Config (11 properties), FieldCondition (9 properties), ScrollRequest (7 properties), HardwareUsage (7 properties). Each schema is shown below with its type and property counts.

MatchExcept
object
Should have at least one value not matching the any given values
1 property 1 required
CountResult
object
1 property 1 required
StopwordsSet
object
2 properties
PointRequest
object
4 properties 1 required
ModelUsage
object
1 property 1 required
FacetValueHit
object
2 properties 2 required
DeleteOperation
object
1 property 1 required
RangeInterface
SnowballParams
object
2 properties 2 required
DocumentOptions
Option variants for text documents. Ether general-purpose options or BM25-specific options. BM25-specific will only take effect if the qdrant/bm25 is specified…
BatchVectorStruct
PointIdsList
object
2 properties 1 required
DeleteVectorsOperation
object
1 property 1 required
Language
string
PayloadSelector
Specifies how to treat payload selector
UpdateResult
object
2 properties 1 required
PointsBatch
object
4 properties 1 required
DatetimeRange
object
Range filter request
4 properties
ValueVariants
UpdateOperations
object
1 property 1 required
VectorStructOutput
Vector data stored in Point
Direction
string
ClearPayloadOperation
object
1 property 1 required
SetPayload
object
This data structure is used in API interface and applied across multiple shards
5 properties 1 required
MatchAny
object
Exact match on any of the given values
1 property 1 required
VectorStruct
Full vector data per point separator with single and multiple vector modes
Usage
object
Usage of the hardware resources, spent to process the request
2 properties
UpsertOperation
object
1 property 1 required
StopwordsInterface
Image
object
WARN: Work-in-progress, unimplemented Image object for embedding. Requires inference infrastructure, unimplemented.
3 properties 2 required
NestedCondition
object
1 property 1 required
InferenceObject
object
WARN: Work-in-progress, unimplemented Custom object for embedding. Requires inference infrastructure, unimplemented.
3 properties 2 required
PointVectors
object
2 properties 2 required
DeletePayload
object
This data structure is used in API interface and applied across multiple shards
4 properties 1 required
OverwritePayloadOperation
object
1 property 1 required
TokenizerType
string
FacetResponse
object
1 property 1 required
SetPayloadOperation
object
1 property 1 required
ScrollRequest
object
Scroll request - paginate over all points which matches given condition
7 properties
OrderByInterface
AnyVariants
IsEmptyCondition
object
Select points with empty payload for a specified field
1 property 1 required
FieldCondition
object
All possible payload filtering conditions
9 properties 1 required
WithVector
Options for specifying which vector to include
Condition
HasVectorCondition
object
Filter points which have specific vector assigned
1 property 1 required
Range
object
Range filter request
4 properties
ScrollResult
object
Result of the points read request
2 properties 1 required
PointStruct
object
3 properties 2 required
PointInsertOperations
ShardKey
ValuesCount
object
Values count filter request
4 properties
OrderBy
object
3 properties 1 required
Vector
Vector Data Vectors can be described directly with values Or specified with source "objects" for inference
MatchPhrase
object
Full-text phrase match of the string.
1 property 1 required
GeoPolygon
object
Geo filter request Matches coordinates inside the polygon, defined by exterior and interiors
2 properties 1 required
Record
object
Point data
5 properties 1 required
ErrorResponse
object
3 properties
StartFrom
InferenceUsage
object
1 property 1 required
FacetValue
Match
Match filter request
DeleteVectors
object
4 properties 1 required
HasIdCondition
object
ID-based filtering condition
1 property 1 required
GeoRadius
object
Geo filter request Matches coordinates inside the circle of radius and center with coordinates center
2 properties 2 required
MatchText
object
Full-text match of the strings.
1 property 1 required
Nested
object
Select points with payload for a specified nested field
2 properties 2 required
IsNullCondition
object
Select points with null payload for a specified field
1 property 1 required
PointsList
object
4 properties 1 required
Batch
object
3 properties 2 required
VectorOutput
Vector Data stored in Point
Filter
object
4 properties
UpdateStatus
string
Acknowledged - Request is saved to WAL and will be process in a queue. Completed - Request is completed, changes are actual. WaitTimeout - Request is waiting f…
Bm25Config
object
Configuration of the local bm25 models.
11 properties
ShardKeyWithFallback
object
2 properties 2 required
CountRequest
object
Count Request Counts the number of points which satisfy the given filter. If filter is not provided, the count of all points in the collection will be returned.
3 properties
ReadConsistency
Read consistency parameter Defines how many replicas should be queried to get the result N - send N random request and return points, which present on all of t…
WriteOrdering
string
Defines write ordering guarantees for collection operations weak - write operations may be reordered, works faster, default medium - write operations go throug…
UpdateOperation
StemmingAlgorithm
Different stemming algorithms with their configs.
ReadConsistencyType
string
majority - send N/2+1 random request and return points, which present on all of them quorum - send requests to all nodes and return points which present on maj…
SparseVector
object
Sparse vector structure
2 properties 2 required
PayloadField
object
Payload field
1 property 1 required
UpdateMode
string
Defines the mode of the upsert operation upsert - default mode, insert new points, update existing points insertonly - only insert new points, do not update ex…
FilterSelector
object
2 properties 1 required
Document
object
WARN: Work-in-progress, unimplemented Text document for embedding. Requires inference infrastructure, unimplemented.
3 properties 2 required
PayloadSelectorInclude
object
1 property 1 required
PayloadSelectorExclude
object
1 property 1 required
GeoBoundingBox
object
Geo filter request Matches coordinates inside the rectangle, described by coordinates of lop-left and bottom-right edges
2 properties 2 required
PointsSelector
MinShould
object
2 properties 2 required
DeletePayloadOperation
object
1 property 1 required
MatchTextAny
object
Full-text match of at least one token of the string.
1 property 1 required
Snowball
string
FacetRequest
object
5 properties 1 required
Payload
object
GeoLineString
object
Ordered sequence of GeoPoints representing the line
1 property 1 required
UpdateVectors
object
3 properties 1 required
SnowballLanguage
string
Languages supported by snowball stemmer.
WithPayloadInterface
Options for specifying which payload to include or not
ExtendedPointId
Type, used for specifying point ID in user interface
OrderValue
HardwareUsage
object
Usage of the hardware resources, spent to process the request
7 properties 7 required
UpdateVectorsOperation
object
1 property 1 required
MatchValue
object
Exact match of the given value
1 property 1 required
GeoPoint
object
Geo point payload schema
2 properties 2 required
ShardKeySelector

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

qdrant-points-api-openapi.yml Raw ↑

Other APIs Qdrant publishes across the network.

Qdrant Aliases API
Qdrant Beta API
Qdrant Collections API
Qdrant Distributed API
Qdrant Indexes API
Qdrant Search API
Qdrant Service API
Qdrant Snapshots API
Where this information came from

This is an independent, third-party profile of Qdrant Points API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.