# YDB-Qdrant OpenAPI specification

Canonical OpenAPI URL: https://ydb-qdrant.tech/openapi.json

YDB-Qdrant publishes an OpenAPI 3.1 specification for its Qdrant-compatible REST subset.

Mutation operations advertise the optional `Idempotency-Key` header so agents can safely retry create, delete, index, upsert, and point-delete requests.

## Covered operations

- `GET /health`
- `PUT /collections/{collection}`
- `GET /collections/{collection}`
- `DELETE /collections/{collection}`
- `PUT /collections/{collection}/index`
- `POST /collections/{collection}/points`
- `PUT /collections/{collection}/points`
- `POST /collections/{collection}/points/upsert`
- `POST /collections/{collection}/points/search`
- `POST /collections/{collection}/points/query`
- `POST /collections/{collection}/points/delete`

## Discovery

- Human-readable API docs: https://ydb-qdrant.tech/docs/api/
- Auth docs: https://ydb-qdrant.tech/docs/auth/
- Agent instructions: https://ydb-qdrant.tech/docs/agents/
- API catalog: https://ydb-qdrant.tech/.well-known/api-catalog
- Developer hub: https://ydb-qdrant.tech/developers/