KdrantException

sealed class KdrantException : Exception

Base type for all errors surfaced by a Kdrant client. A sealed hierarchy lets callers exhaustively when over the failure modes.

Note: kotlinx.coroutines.CancellationException is never wrapped in a KdrantException; it must always propagate so structured concurrency and cancellation keep working.

Inheritors

Types

AlreadyExists

class AlreadyExists(message: String) : KdrantException

The collection or resource already exists (HTTP 409). Not retryable.

CollectionNotFound

class CollectionNotFound(val collection: String, serverMessage: String? = null) : KdrantException

The referenced collection does not exist.

InvalidRequest

class InvalidRequest(message: String) : KdrantException

The server rejected the request as malformed (HTTP 4xx other than auth/not-found).

RateLimited

class RateLimited(val retryAfter: Duration? = null, message: String = "Rate limited by Qdrant (HTTP 429)") : KdrantException

The server rejected the request because it is rate-limited (HTTP 429). Retryable: the client already retried with backoff, honoring the server's Retry-After, before surfacing this.

ServerError

class ServerError(message: String) : KdrantException

An unexpected server-side error (HTTP 5xx other than 503). Not retried automatically.

ServiceUnavailable

class ServiceUnavailable(message: String = "Qdrant is temporarily unavailable (HTTP 503)") : KdrantException

Qdrant is temporarily unavailable (HTTP 503, e.g. a shard is not ready). Retryable: surfaced only after the client's retries were exhausted.

Timeout

class Timeout(message: String, cause: Throwable? = null) : KdrantException

The request exceeded its configured timeout.

Transport

class Transport(message: String, cause: Throwable? = null) : KdrantException

A transport/connection-level failure — Qdrant could not be reached (connection refused, DNS failure, connection reset, ...). Transient I/O failures are retried with backoff before this is surfaced.

Unauthorized

class Unauthorized(message: String = "Unauthorized") : KdrantException

Authentication failed or is required (missing/invalid API key).

Properties

cause

open val cause: Throwable?

message

open val message: String?