Skip to main content

Debug: Endpoints

  • This page lists the HTTP endpoints that a RavenDB server exposes, in two groups:
    debug endpoints, which report internal server and database information for diagnostics,
    and production endpoints, which make up the rest of the server's REST API.

  • The two groups mirror the output of the /debug/routes endpoint, which sorts every registered route into the debug and production groups.
    To get the current, complete list from a running server, call /debug/routes; the list on this page captures the routes for the RavenDB version documented here.

  • In this article:

Debug endpoints

Debug endpoints report internal information about a RavenDB server and its databases, for diagnostics rather than normal application traffic.

  • Call a debug endpoint to inspect live state while investigating a problem.
    e.g., to read a node's memory and CPU usage, list the queries currently running on a database, or get a database's storage report.
  • The table below lists each endpoint, the HTTP methods it accepts, and what it reports.
  • Where an endpoint accepts parameters, pass them as query-string parameters on the request URL.
    e.g., /admin/debug/memory/stats?includeThreads=false
  • In the /databases/*/... endpoints, * stands for the name of the target database.
    e.g., /databases/Orders2024/debug/queries/running
EndpointMethodDescription
/admin/cluster/logGETThe entries in the cluster's Rachis (Raft) consensus log.

Parameters:
  • from: the starting log index (optional)
  • pageSize: number of entries to return (optional, default 1024)
  • detailed: include detailed entry information (optional, default false)
/admin/cluster/observer/decisionsGETThe cluster observer's decision log: each entry's date, database, and message, plus the observer's current iteration and suspended state. Only the cluster leader serves this request; other nodes redirect to the leader.
/admin/debug/cluster-info-packageGETDownloads a .zip debug package with diagnostic information gathered from every node in the cluster, one sub-archive per node.

Parameters:
  • timeoutInSecPerNode: per-node timeout for collecting the package, in seconds (optional, default 3600)
  • type: which content to include per node (ServerWide, Databases, LogFile, or a combination) (optional, default all three)
  • database: limit the package to the named database or databases (optional, multi-valued)
/admin/debug/cluster/history-logsGETThe cluster's history-log entries.
/admin/debug/cpu/statsGETThe RavenDB process's CPU times and processor affinity, and .NET thread-pool statistics.
/admin/debug/info-packageGETDownloads a .zip debug package with diagnostic information for a single node (the server that handles the request): server-wide info, the requested databases' info, and the current log file, depending on type.

Parameters:
  • type: which content to include (ServerWide, Databases, LogFile, or a combination) (optional, default all three)
  • database: limit the package to the named database or databases (optional, multi-valued)
/admin/debug/info/tcp/active-connectionsGETThe active TCP connections reported by the operating system, with a total count and each connection's local and remote endpoint, grouped by connection state.
/admin/debug/info/tcp/statsGETIPv4 and IPv6 TCP statistics reported by the operating system.
/admin/debug/io-metricsGETI/O metrics (writes, flushes, and syncs) for the server's storage environment.
/admin/debug/memory/encryption-buffer-poolGETStatistics for the encryption buffer pool: whether it is disabled, total pool size, size currently in use, and the per-core and global allocation breakdown.
/admin/debug/memory/gcGETA .NET garbage-collector memory report per GC kind: heap size, fragmentation, per-generation sizes (including the large-object and pinned-object heaps), pause times, and memory load.
/admin/debug/memory/low-mem-logGETThe low-memory events the server has recorded, each with its free, committed, unmanaged, and scratch-dirty memory, physical memory, and the low-memory threshold at the time.
/admin/debug/memory/statsGETA full memory-usage report: managed and unmanaged allocations, encryption buffers, memory-mapped files, per-thread allocations, and dirty-memory state.

Parameters:
  • includeThreads: include per-thread allocations (optional, default true)
  • includeMappings: include memory-mapped files (optional, default true)
/admin/debug/node/engine-logsGETRecent in-memory log entries from the node's Rachis (cluster consensus) engine.
/admin/debug/node/pingGETTests connectivity from this node to another cluster node, or to every node in the cluster topology if url/node is omitted: calls /setup/alive and negotiates a TCP connection, and reports the round-trip time or error for each target.

Parameters:
  • url: the target node's URL (optional)
  • node: the target node's tag, used if url is not given (optional)
  • setStatusCodeOnError: return HTTP 503 if any ping fails (optional, default false)
/admin/debug/node/remote-connectionsGETThe node's active Rachis (Raft) connections: for each, the caller, destination, term, start time, duration, and connection number.
/admin/debug/node/state-change-historyGETThe node's history of Rachis state transitions (leader, follower, candidate, and so on).
/admin/debug/proc/meminfoGETThe contents of the /proc/meminfo file.
  • Linux only
/admin/debug/proc/statsGETDetailed .NET process information for the RavenDB process: memory sizes, working set, processor times, threads, and loaded modules.
/admin/debug/proc/statusGETThe contents of the /proc/self/status file for the RavenDB process.
  • Linux only
/admin/debug/threads/runawayGETThe server's threads ranked by CPU usage over a short sampling interval, to spot a thread consuming excessive CPU.

Parameters:
  • samplesCount: number of samples to collect (optional, default 1)
  • intervalInMs: delay between samples (optional, default: the server's CPU sampling interval)
  • maxTopThreads: return only the top threads by usage (optional)
/admin/debug/threads/stack-traceGETLive stack traces of the server's threads.
  • Not available on macOS

Parameters:
  • threadId: limit to specific thread IDs (optional, multi-valued)
  • includeStackObjects: include stack objects (optional, default false)
  • download: return the result as a downloadable file (optional, default false)
/admin/debug/txinfoGETActive-transaction information for the server-store storage environment.
/admin/indexes/lucene/query-clause-cacheGETThe contents of the Lucene query-clause cache, grouped by database, index, and query text, with item counts and sizes, plus an overall summary.
/admin/server/notificationsGETThe notifications stored in the server-wide Notification Center.

Parameters:
  • postponed: include postponed notifications (optional, default true)
  • type: filter to a notification type or types, comma-separated (optional)
  • pageStart: number of results to skip (optional, default 0)
  • pageSize: number of results to return (optional, default all)
/admin/statsGETThe node's uptime, start time, last request time, last non-ClusterAdmin authorized request time, and the last request time per client certificate thumbprint.
/build/versionGETThe server's build number, product version, commit hash, and full version string.
/cluster/topologyGETThe current cluster topology: members, watchers, and their URLs.
/databases/*/admin/configuration/settingsGET, PUTThe database's configuration settings. GET reads the effective settings; PUT updates them from the request body.

Parameters (GET only):
  • scope: filter to a configuration entry scope (ServerWideOnly, ServerWideOrPerDatabase, or ServerWideOrPerDatabaseOrPerIndex) (optional)
/databases/*/admin/debug/cluster/txinfoGETThe database's cluster-wide transaction commands, read as a batch from the cluster state machine.

Parameters:
  • from: number of commands to skip (optional)
  • take: number of commands to return (optional, default unlimited)
/databases/*/admin/debug/txinfoGETActive-transaction information for the database's storage environments.
/databases/*/admin/tombstones/stateGETThe tombstone-cleanup state: the tombstones held per collection and what is blocking their cleanup.
/databases/*/ai/errorsGET, DELETERecent errors recorded for the database's AI tasks (Embeddings Generation, Gen AI). GET lists them; DELETE clears them.

Parameters:
  • name: the task name or names to filter to (optional for GET, multi-valued; required for DELETE)
/databases/*/cdc-sink/errorsGET, DELETERecent errors recorded for the database's CDC sink tasks. GET lists them; DELETE clears them.

Parameters:
  • name: the task name or names to filter to (optional for GET, multi-valued; required for DELETE)
/databases/*/collections/stats/detailedGETDetailed per-collection statistics (document, revision, tombstone, counter, and time-series counts and sizes), plus database-wide totals for documents, conflicts, revisions, tombstones, attachments, counters, and time series.
/databases/*/debug/documents/hugeGETDocuments that exceeded the huge-document size hint (PerformanceHints.Documents.HugeDocumentSizeInMb).
/databases/*/debug/identitiesGETThe database's identity values: the latest number issued for each identity prefix.

Parameters:
  • start: number of results to skip (optional, default 0)
  • pageSize: number of results to return (optional, default all)
/databases/*/debug/info-packageGETDownloads a .zip debug package with diagnostic information for the database.
/databases/*/debug/io-metricsGETI/O metrics (writes, flushes, and syncs) for the database's storage environments.
/databases/*/debug/perf-metricsGETTransaction performance metrics for each of the database's storage environments.
/databases/*/debug/queries/cache/listGETThe queries currently held in the database's query cache, with each entry's query text, creation and last-use times, index or collection, and query-shape flags (for example group-by, distinct, or has-facet), plus the total cached count.
/databases/*/debug/queries/runningGETThe database's currently running queries, grouped by index name.
/databases/*/debug/script-runnersGETDebug information about the database's JavaScript script runners (used by patching and other JavaScript features).

Parameters:
  • detailed: include detailed per-runner information (optional, default false)
/databases/*/debug/storage/reportGETA storage report for the database: space used per storage environment, table, and index.
/databases/*/etl/errorsGET, DELETERecent errors recorded for the database's ETL tasks. GET lists them; DELETE clears them.

Parameters:
  • name: the task name or names to filter to (optional for GET, multi-valued; required for DELETE)
/databases/*/etl/progressGETProgress of the database's ETL tasks: task name, ETL type, per-process progress, and (for queue ETL) the queue-broker type.

Parameters:
  • name: filter to the named ETL task or tasks (optional, multi-valued)
/databases/*/etl/statsGETStatistics for the database's ETL tasks: task ID, type, and per-transformation statistics.

Parameters:
  • name: filter to the named ETL task or tasks (optional, multi-valued)
/databases/*/indexesGET, PUT, DELETE, RESETThe database's indexes. GET returns index definitions; PUT creates or updates a JavaScript-defined index (static, non-JavaScript index definitions use /databases/*/admin/indexes); DELETE removes an index; RESET rebuilds an index.

Parameters:
  • name: index name or names (GET: optional, multi-valued, filters the results; DELETE and RESET: required, single name)
  • namesOnly: return only index names instead of full definitions (GET only, optional, default false)
  • start, pageSize: pagination for GET when listing all indexes (optional)
  • mode: index reset mode (RESET only, optional)
/databases/*/indexes/debug/metadataGETLow-level metadata for the database's indexes: version, type, state, lock mode, source type, priority, search-engine type, dynamic-fields and compare-exchange flags, and time fields.

Parameters:
  • name: filter to the named index or indexes (optional, multi-valued)
/databases/*/indexes/errorsGET, DELETEIndexing errors for the database's indexes. GET lists them; DELETE clears them.

Parameters:
  • name: filter to the named index or indexes (optional, multi-valued; if omitted, all indexes)
  • start, pageSize: pagination of each index's error list (GET only, optional)
/databases/*/indexes/performanceGETDetailed indexing-performance statistics for the database's indexes.

Parameters:
  • name: filter to the named index or indexes (optional, multi-valued)
/databases/*/indexes/statsGETStatistics for the database's indexes: type, state, lock mode, priority, staleness, lag, memory usage, and referenced collections.

Parameters:
  • name: limit to a single named index (optional)
/databases/*/notificationsGETThe notifications stored in the database's Notification Center.

Parameters:
  • postponed: include postponed notifications (optional, default true)
  • type: filter to a notification type or types, comma-separated (optional)
  • pageStart: number of results to skip (optional, default 0)
  • pageSize: number of results to return (optional, default all)
/databases/*/replication/debug/incoming-last-activity-timeGETThe last activity time of each incoming replication connection.
/databases/*/replication/debug/incoming-rejection-infoGETInformation about rejected incoming replication connections.
/databases/*/replication/debug/outgoing-failuresGETFailures recorded for outgoing replication connections.
/databases/*/replication/debug/outgoing-reconnect-queueGETOutgoing replication connections waiting to reconnect.
/databases/*/replication/internal/outgoing/progressGETProgress of outgoing internal replication to the other nodes in the database group.
/databases/*/replication/progressGETProgress of the database's outgoing external and pull replication tasks toward their destinations.

Parameters:
  • name: filter to the named replication task or tasks (optional, multi-valued)
/databases/*/statsGETStatistics for the database: document count, index count, sizes, and so on.
/databases/*/subscriptionsGET, PUT, DELETEThe database's data subscriptions. GET lists them, or returns one by id or name; PUT creates or updates one from the request body; DELETE removes one.

Parameters:
  • id: return only the subscription with this ID (GET only, optional)
  • name: return only the subscription with this name (GET only, optional)
  • taskName: the subscription to delete (DELETE only, required)
  • start, pageSize: pagination when listing all subscriptions (GET only, optional)
  • history: include connection history (GET only, optional, default false)
  • running: limit to currently running subscriptions (GET only, optional, default false)
/databases/*/tasksGETThe database's ongoing tasks (ETL, replication, backups, subscriptions, and so on).
/databases/*/tcpGET, DELETEThe database's active TCP connections. GET lists them; DELETE force-disconnects one.

Parameters:
  • id: the connection ID to disconnect (DELETE only, required)
/debug/cpu-creditsGETThe server's CPU-credits state: remaining and maximum credits, background-task and failover thresholds, current consumption, machine CPU usage, gain rate, and per-minute history.
/debug/server-idGETThe server's unique identifier.
/license-server/connectivityGETChecks whether the server can reach RavenDB's license server.

Production endpoints

Production endpoints make up the rest of the server's REST API, used in normal operation rather than for diagnostics. The table lists each route and the HTTP methods it accepts.

EndpointMethodDescription
/GETThe server home page (redirects to Studio).
/2fa/$GETServes a static asset for the two-factor authentication page.
/2fa/index.htmlGETServes the two-factor authentication page if two-factor authentication is pending for the connection; otherwise redirects to Studio.
/admin/ai/test-connectionPOSTTests a connection to an AI service using the connector type and settings supplied in the request body.

Parameters:
  • type: the AI connector type (required)
  • modelType: the AI model type (required)
/admin/analyzersPUT, DELETEPUT registers server-wide custom analyzers from the request body; DELETE removes one by name.

Parameters:
  • name: name of the analyzer to delete (required, DELETE only)
/admin/backup-task/delayPOSTDelays a backup task by the specified duration.

Parameters:
  • taskId: identifier of the backup task to delay (required)
  • duration: length of the delay (required)
  • database: the database that owns the backup task (required)
/admin/certificatesGET, PUT, POST, DELETEGET lists client certificates; PUT registers an existing certificate; POST generates a new one; DELETE removes one by thumbprint.
/admin/certificates/2fa/generateGETGenerates a secret for two-factor authentication.
/admin/certificates/cluster-domainsGETThe host names of the cluster's nodes, or this node's own host name if it is not part of a cluster yet.
/admin/certificates/editPOSTEdits an existing client certificate's permissions, security clearance, and other metadata.

Parameters:
  • deleteTwoFactorConfiguration: remove the certificate's two-factor authentication configuration (optional, default false)
/admin/certificates/exportGETExports the server's certificate and the cluster's node certificates as a downloadable .pfx file.
/admin/certificates/for-communication/exportGETExports the public certificate the server uses for communication.
/admin/certificates/letsencrypt/force-renewPOSTForces renewal of the Let's Encrypt server certificate.
/admin/certificates/letsencrypt/renewal-dateGETThe estimated renewal date of the Let's Encrypt server certificate.
/admin/certificates/local-stateGET, DELETEGET returns the certificates held in the node's local state; DELETE removes them.
/admin/certificates/local-state/applyPOSTApplies the node's local-state certificates to the cluster.
/admin/certificates/modeGETThe server's certificate setup mode.
/admin/certificates/purgeDELETEDeletes expired certificates from the cluster.
/admin/certificates/refreshPOSTTriggers the certificate refresh cycle immediately.

Parameters:
  • replaceImmediately: replace the certificate on this node right away if it changed on disk (optional, default false)
/admin/certificates/replace-cluster-certPOSTReplaces the cluster certificate with the posted certificate.

Parameters:
  • replaceImmediately: replace the certificate on this node right away instead of waiting for the next refresh cycle (optional, default false)
/admin/certificates/replacement/resetPOSTResets an in-progress certificate replacement by clearing its state.
/admin/certificates/replacement/statusGETThe status of an ongoing certificate replacement.
/admin/certificates/sso/server/fetchGETFetches an SSO server certificate from the specified URL.

Parameters:
  • url: address to fetch the certificate from (required)
/admin/certificates/sso/userPUTRegisters an SSO user.
/admin/cluster-dashboard/remote/watchGETStreams this node's Cluster Dashboard notifications over a WebSocket, for use when another node proxies a dashboard view from this one.

Parameters:
  • thumbprint: thumbprint of the client certificate originally used to connect, to scope which databases are visible (optional)
/admin/cluster/bootstrapPOSTBootstraps a single-node cluster on this server.

Parameters:
  • tag: node tag to assign to this node (optional)
/admin/cluster/demotePOSTDemote a node to a watcher.

Parameters:
  • nodeTag: tag of the node to demote (required)
/admin/cluster/log/entryGETA single Raft log entry, retrieved by index.

Parameters:
  • index: index of the log entry to return (required)
/admin/cluster/maintenance-statsGETThe cluster maintenance statistics the leader collects from each node.
/admin/cluster/nodePUT, DELETEAdd (PUT) or remove (DELETE) a node from the cluster.

Parameters:
  • url: URL of the node to add (required, PUT only)
  • tag: node tag to assign (optional, PUT only)
  • watcher: add the node as a non-voting watcher (optional, PUT only)
  • maxUtilizedCores: maximum CPU cores the added node may use (optional, PUT only)
  • nodeTag: tag of the node to remove (required, DELETE only)
/admin/cluster/observer/suspendPOSTSuspends or resumes the cluster observer.

Parameters:
  • value: true to suspend the observer, false to resume it (required)
/admin/cluster/promotePOSTPromote a node to a voting member.

Parameters:
  • nodeTag: tag of the node to promote (required)
/admin/cluster/reelectPOSTForce a new cluster leader election.
/admin/cluster/remove-entry-from-logPOSTRemoves an entry from the Raft log by index.

Parameters:
  • index: index of the log entry to remove (required)
/admin/cluster/timeoutPOSTForce the current node's election timeout.
/admin/compactPOSTCompact a database's storage to reclaim disk space.
/admin/configuration/clientPUTSaves the server's client configuration.
/admin/configuration/server-wideGETThe server-wide backup configuration: local root path and allowed AWS regions and destinations.
/admin/configuration/server-wide/backupGET, PUT, DELETEGET returns the server-wide backup configurations; PUT saves one; DELETE removes one.

Parameters:
  • name: task name to filter by (optional, GET) or to remove (required, DELETE)
/admin/configuration/server-wide/connection-stringsGET, PUT, DELETEGET returns server-wide connection strings; PUT saves one; DELETE removes one.

Parameters:
  • name: connection string name to filter by (optional, GET) or to remove (required, DELETE)
  • type: connection string type (optional, GET; required, DELETE)
/admin/configuration/server-wide/external-replicationPUTSaves a server-wide external replication configuration.
/admin/configuration/server-wide/statePOSTEnables or disables a server-wide task.

Parameters:
  • type: the ongoing task type (required)
  • name: the task name (required)
  • disable: true to disable the task, false to enable it (optional, default true)
/admin/configuration/server-wide/taskDELETERemoves a server-wide task by name and type.

Parameters:
  • type: the ongoing task type (required)
  • name: the task name (required)
/admin/configuration/server-wide/tasksGETReturns the server-wide tasks of a given type (backup or external replication).

Parameters:
  • type: the ongoing task type, Backup or Replication (required)
  • name: filter by task name (optional)
/admin/configuration/settingsGETReturns the server's configuration settings.

Parameters:
  • scope: filter entries by configuration entry scope (optional)
/admin/configuration/studioPUTSaves the server-wide Studio configuration.
/admin/consolePOSTRuns an administrative JavaScript console script, either against the server or against a specific database.

Parameters:
  • serverScript: run the script against the server rather than a database (optional, default false)
  • database: name of the database to run the script against, required unless serverScript is true (optional)
/admin/cpu-creditsPOSTSets the server's remaining CPU credits.
/admin/cpu-credits/syncPOSTForces an immediate CPU-credits synchronization.
/admin/databasesGET, PUT, DELETEGET returns database records; PUT creates a database; DELETE deletes one or more databases.
/admin/databases/disablePOSTDisable one or more databases.
/admin/databases/dynamic-node-distributionPOSTEnables or disables dynamic node distribution for a database.

Parameters:
  • name: name of the database (required)
  • enable: true to enable, false to disable (optional, default true)
/admin/databases/enablePOSTEnable one or more databases.
/admin/databases/indexingPOSTEnables or disables indexing for one or more databases.

Parameters:
  • enable: true to enable indexing, false to disable it (optional, default true)
/admin/databases/nodePUTAdds a node to an existing database group.

Parameters:
  • name: name of the database (required)
  • node: tag of the node to add (optional, chosen automatically if omitted)
  • mentor: tag of the node to use as the initial replication mentor (optional)
/admin/databases/orchestratorPUT, DELETEPUT adds a node to a sharded database's orchestrator topology; DELETE removes one.

Parameters:
  • name: name of the database (required)
  • node: tag of the node to add or remove (optional for PUT, chosen automatically if omitted; required for DELETE)
/admin/databases/promotePOSTPromote a database-group node to a full member.

Parameters:
  • name: name of the database (required)
  • node: tag of the node to promote (required)
/admin/databases/reorderPOSTReorder the members of a database group.

Parameters:
  • name: name of the database (required)
/admin/databases/set-lockPOSTSets the deletion lock mode for one or more databases.
/admin/databases/shardPUTAdds a new shard to a sharded database.

Parameters:
  • name: name of the database (required)
  • shardNumber: shard number to assign (optional, chosen automatically if omitted)
  • node: node tags to place the shard's replicas on, may repeat (optional)
  • replicationFactor: number of replicas for the new shard (optional)
  • dynamicNodeDistribution: enable dynamic node distribution for the new shard (optional)
/admin/databases/topology/modifyPOSTModifies a database's topology.

Parameters:
  • name: name of the database (required)
/admin/databases/unused-idsPOSTRegister the set of unused database IDs for a database, supplied in the request body.

Parameters:
  • name: the target database (required)
  • validate: validate the supplied IDs before saving (optional, default false)
/admin/debug/databases/idleGETReturn idle-state information for recently used databases, including whether each can be unloaded, along with the configured idle timeout and check frequency.
/admin/debug/dumpGETCreate a process memory dump of the requested type and download it as a gzip-compressed file.

Parameters:
  • type: the memory dump type to create
  • path: server-side directory for the temporary dump file (optional, default system temp directory)
/admin/debug/gcdumpGETCreate a GC (Garbage Collector) memory dump and download it as a gzip-compressed file.

Parameters:
  • timeout: seconds to wait while collecting the dump (optional, default 30)
  • path: server-side directory for the temporary dump file (optional, default system temp directory)
/admin/debug/io-metrics/liveGETStream the server's live I/O metrics over a WebSocket.
/admin/debug/memory/allocationsGETCollect managed memory allocations over a sampling window and return them grouped by allocating type.

Parameters:
  • delay: length of the sampling window in seconds (optional, default 5)
/admin/debug/memory/gc-eventsGETCollect garbage-collection events over a sampling window and return the top five by duration, plus the full list of collected events.

Parameters:
  • delay: length of the sampling window in seconds (optional, default 10)
/admin/debug/memory/smapsGETReturn a memory-mapping report for the server process.
/admin/debug/node/clear-http-clients-poolGETClear the server's internal pool of cached HTTP clients.
/admin/debug/operations/longest-runningGETReturns the longest-running active operation for each operation type, across the server and its loaded databases.
/admin/debug/periodic-backup/timersGETReturn the periodic-backup timers for the currently loaded databases on this node.
/admin/debug/remote-cluster-info-packageGETReturn a debug-information package (ZIP) for this node, containing server info and the requested databases, for use when assembling a cluster-wide debug package.
/admin/debug/script-runnersGETReturn debug information about the server's JavaScript script runners.

Parameters:
  • detailed: include detailed per-runner information (optional, default false)
/admin/debug/storage/environment/reportGETReturn a storage report for the server-store (system) Voron environment.

Parameters:
  • details: include a detailed report (optional, default false)
/admin/debug/storage/environment/scratch-buffer-infoGETReturn scratch-buffer pool information for the server-store (system) Voron environment.
/admin/debug/threads/contentionGETCollect thread lock-contention events over a sampling window and return the top five by duration plus the full list of events in chronological order.

Parameters:
  • delay: length of the sampling window in seconds (optional, default 30)
/admin/etl/elasticsearch/test-connectionPOSTTest a connection to an Elasticsearch destination using the supplied connection settings.

Parameters:
  • url: URL of the Elasticsearch node to connect to
/admin/etl/queue/amazonsqs/test-connectionPOSTTest a connection to an Amazon SQS queue destination using the supplied connection settings.
/admin/etl/queue/azurequeuestorage/test-connectionPOSTTest a connection to an Azure Queue Storage destination using the supplied connection settings.
/admin/etl/queue/azureservicebus/test-connectionPOSTTest a connection to an Azure Service Bus destination using the supplied connection settings.
/admin/etl/queue/kafka/test-connectionPOSTTest a connection to a Kafka destination using the supplied connection settings.
/admin/etl/queue/rabbitmq/test-connectionPOSTTest a connection to a RabbitMQ destination using the supplied connection settings.
/admin/etl/snowflake/test-connectionPOSTTest a connection to a Snowflake destination using the supplied connection settings.
/admin/etl/sql/test-connectionPOSTTest a connection to a relational (SQL) database destination using the supplied connection settings.

Parameters:
  • factoryName: name of the .NET database provider factory to use for the connection test
/admin/event-listener/configurationGET, POSTGet (GET) or set (POST) the server's event-listener configuration.
/admin/license/activatePOSTActivate a license.
/admin/license/eula/acceptPOSTAccept the license EULA (End User License Agreement).
/admin/license/forceUpdatePOSTForce a license update from the license server.
/admin/license/renewPOSTRenew the current license.
/admin/license/set-limitPOSTSet the maximum number of licensed CPU cores a cluster node may use.

Parameters:
  • nodeTag: tag of the node to limit
  • maxUtilizedCores: maximum number of cores the node may use (optional)
/admin/logs/configurationGET, POSTGet (GET) or change (POST) the server's log configuration at runtime.
/admin/logs/downloadGETDownload the server's log files as a ZIP archive.

Parameters:
  • from: only include files last modified after this date (optional)
  • to: only include files created before this date (optional)
/admin/logs/watchGETStream the server's live log entries over a WebSocket.
/admin/memory/gcGETTrigger a .NET garbage collection on the server.

Parameters:
  • loh: also compact the LOH (Large Object Heap) once (optional, default false)
/admin/metricsGETReturn the server's metrics in JSON.
/admin/migratePOSTMigrate databases from another live RavenDB server, using the migration configuration in the request body.
/admin/migrate/offlinePOSTMigrate a database from offline data files, using the migration configuration in the request body.
/admin/monitoring/v1/ai-tasksGETPer-database AI-task monitoring metrics in JSON.

Parameters:
  • name: limit to this database (optional, may be repeated to include multiple databases)
/admin/monitoring/v1/cdc-sinksGETPer-database CDC (Change Data Capture) sink monitoring metrics in JSON.

Parameters:
  • name: limit to this database (optional, may be repeated to include multiple databases)
/admin/monitoring/v1/collectionsGETPer-collection monitoring metrics in JSON.

Parameters:
  • name: limit to this database (optional, may be repeated to include multiple databases)
/admin/monitoring/v1/databasesGETPer-database monitoring metrics in JSON.

Parameters:
  • name: limit to this database (optional, may be repeated to include multiple databases)
/admin/monitoring/v1/etlsGETPer-database ETL monitoring metrics in JSON.

Parameters:
  • name: limit to this database (optional, may be repeated to include multiple databases)
/admin/monitoring/v1/indexesGETPer-index monitoring metrics in JSON.

Parameters:
  • name: limit to this database (optional, may be repeated to include multiple databases)
/admin/monitoring/v1/prometheusGETServer metrics in Prometheus format.

Parameters:
  • skipServerMetrics: exclude server-level metrics (optional, default false)
  • skipDatabasesMetrics: exclude per-database metrics (optional, default false)
  • skipIndexesMetrics: exclude per-index metrics (optional, default false)
  • skipCollectionsMetrics: exclude per-collection metrics (optional, default false)
  • skipEtlsMetrics: exclude per-ETL metrics (optional, default false)
  • skipAiTasksMetrics: exclude per-AI-task metrics (optional, default false)
  • skipCdcSinksMetrics: exclude per-CDC-sink metrics (optional, default false)
  • includeGcMetrics: include garbage-collection metrics (optional, default false)
/admin/monitoring/v1/serverGETServer monitoring metrics in JSON, for external monitoring tools.
/admin/operations/killPOSTAbort a running server operation.

Parameters:
  • id: ID of the operation to abort
/admin/operations/next-operation-idGETGet the next server operation ID.
/admin/rachis/sendPOSTSubmit a Raft (cluster) command to the leader for the cluster to apply.
/admin/remote-server/build/versionGETRetrieve build-version and database information from a remote RavenDB server.

Parameters:
  • serverUrl: URL of the remote server to query
  • userName: username for authenticating to the remote server (optional)
  • password: password for authenticating to the remote server (optional)
  • domain: domain for authenticating to the remote server (optional)
  • apiKey: API key for authenticating to the remote server (optional)
  • enableBasicAuthenticationOverUnsecuredHttp: allow Basic authentication over an unsecured HTTP connection (optional, default false)
  • skipServerCertificateValidation: skip validation of the remote server's TLS certificate (optional, default false)
/admin/replication/conflicts/solverPOSTUpdate the conflict-resolution configuration for a database.

Parameters:
  • name: the database whose conflict solver to update
/admin/resharding/startPOSTStart a resharding operation that moves a range of buckets to another shard in a sharded database.

Parameters:
  • database: the sharded database
  • fromBucket: first bucket in the range to move
  • toBucket: last bucket in the range to move
  • toShard: the destination shard number
/admin/restore/databasePOSTRestore a database from a backup.
/admin/restore/pointsPOSTList the available restore points in a backup location.

Parameters:
  • type: backup storage connection type, Local, S3, Azure, or GoogleCloud (optional, default Local)
/admin/secretsGET, POSTList stored secret-key names (GET) or store a secret key (POST).

Parameters:
  • name: the resource name for the key to store (POST only)
  • overwrite: replace an existing key with the same name (POST only, optional, default false)
/admin/secrets/distributePOSTDistribute a secret key to the specified cluster nodes.

Parameters:
  • name: the resource name the key belongs to
  • node: tag of a node to receive the key (may be repeated)
/admin/secrets/generateGETGenerate a random 256-bit secret key and return it as a base64 string.
/admin/server-wide/backup-data-directoryGETResolve and return information about a server-wide backup data directory for the given path.

Parameters:
  • path: the directory path to inspect
  • requestTimeoutInMs: timeout for querying other nodes, in milliseconds (optional, default 5000)
  • getNodesInfo: also return directory information from other cluster nodes (optional, default false)
/admin/server-wide/tasksGETReturn the configured server-wide tasks.

Parameters:
  • name: filter to a task with this name (optional)
  • type: filter to tasks of this type (optional)
/admin/sortersPUT, DELETEAdd or update (PUT) or delete (DELETE) a server-wide custom sorter.

Parameters:
  • name: name of the sorter to delete (DELETE only)
/admin/studio-tasks/folder-path-optionsPOSTReturn folder-path options (subfolder suggestions) for a given path or backup destination, used by Studio directory pickers.

Parameters:
  • type: backup storage connection type, Local, S3, Azure, or GoogleCloud (optional, default Local)
  • path: the path to list subfolder options for (optional)
  • backupFolder: treat the path as a backup folder (optional, default false)
/admin/studio-tasks/full-data-directoryGETResolve and return the full data-directory path that a database would use, given a path or a database name.

Parameters:
  • path: an explicit directory path, which overrides name (optional)
  • name: a database name, used to derive its data directory (optional)
  • requestTimeoutInMs: timeout for querying other nodes, in milliseconds (optional, default 5000)
  • getNodesInfo: also return directory information from other cluster nodes (optional, default false)
/admin/studio-tasks/offline-migration-testGETValidate the data directory or migrator path for an offline migration.

Parameters:
  • mode: validation mode, dataDir or migratorPath
  • path: the path to validate
/admin/test-connectionPOSTTest the connection from this server to a remote node.

Parameters:
  • url: URL of the remote node
  • database: database to test against (optional)
  • bidirectional: also test the connection from the remote node back to this server (optional, default false)
/admin/test/delayGETDelay the response by the specified number of milliseconds.

Parameters:
  • value: delay in milliseconds
/admin/test/empty-messageGETReturn an empty response.
/admin/test/sized-messageGETReturn a response of random bytes, sized as a number of 32 KB blocks.

Parameters:
  • count: number of 32 KB blocks to return (optional, default 1)
/admin/traffic-watchGETThe Traffic Watch live request-stream WebSocket endpoint.

Parameters:
  • resourceName: restrict the stream to a specific database (optional)
/admin/traffic-watch/configurationGET, POSTGet (GET) or update (POST) the Traffic Watch log-to-file configuration.
/analyzersGETList the server-wide custom analyzers.

Parameters:
  • namesOnly: return only analyzer names, without their code (optional, default false)
/assistant/assistPOSTSend a request to the AI Assistant.
/assistant/check-consentGETCheck whether consent to use the AI Assistant has been given.
/assistant/check-usageGETReturn the AI Assistant usage information.
/assistant/give-consentPOSTGive consent to use the AI Assistant.
/assistant/settingsGETReturn the AI Assistant settings (whether the assistant and data submission are disabled).
/auth-error.htmlGETThe Studio authentication-error page. Redirects to Studio when the caller is already authorized.

Parameters:
  • ae, ao, rt: encoded authentication status, authorization status, and resource type used to build the displayed error message (optional)
/authentication/2faPOST, DELETEValidate a two-factor authentication token to open a session (POST), or end the current two-factor session (DELETE).

Parameters:
  • hasLimits: bind the session to a browser cookie (optional, default true)
  • sessionDurationInMin: session length in minutes (optional, default is the server's configured default)
/authentication/2fa/configurationGETReturn the two-factor authentication session-duration settings (default and maximum, in minutes).
/build/version/updatesPOSTReturn information about available RavenDB version updates.

Parameters:
  • refresh: trigger a fresh check for updates before responding (optional, default false)
/certificates/whoamiGETThe certificate definition the caller is authenticated with.
/cluster-dashboard/watchGETLive WebSocket stream of Cluster Dashboard data for a node.

Parameters:
  • node: tag of the node to watch
/cluster/node-infoGETInformation about this cluster node.
/configuration/clientGETReturn the server-wide client configuration.
/configuration/studioGETReturn the server-wide Studio configuration.
/databasesGETReturn the list of databases on the server, or a single database's record when name is specified.

Parameters:
  • name: return only this database (optional)
  • namesOnly: return only database names instead of full records (optional, default false)
  • start: number of results to skip, for paging (optional, default 0)
  • pageSize: maximum number of results to return (optional)
/databases/*/admin/ai/agentGET, PUT, DELETEGet (GET), add or update (PUT), or delete (DELETE) an AI agent definition for the database.

Parameters:
  • agentId: the AI agent identifier (optional for GET, returns all agents when omitted; required for DELETE)
/databases/*/admin/ai/agent/generate-codeGETGenerate code for an AI agent for the database.

Parameters:
  • agentId: the AI agent identifier
  • language: the target language, C#, JavaScript, or Python
/databases/*/admin/ai/embeddings/testPOSTTest an embeddings generation script for the database.
/databases/*/admin/ai/gen-ai/testPOSTTest a Gen AI script for the database.
/databases/*/admin/ai/test-connectionPOSTTest an AI connection string for the database.
/databases/*/admin/analyzersPUT, DELETEAdd or update (PUT) or delete (DELETE) a custom analyzer for the database.
/databases/*/admin/attachments/remote/configGET, PUTGet (GET) or set (PUT) the remote attachments configuration for the database.
/databases/*/admin/backupPOSTStart a one-time backup for the database.
/databases/*/admin/backup-data-directoryGETReturn information about a backup data directory for the database.

Parameters:
  • path: the directory to inspect
  • requestTimeoutInMs: request timeout in milliseconds (optional, default 5000)
  • getNodesInfo: include information from other cluster nodes (optional, default false)
/databases/*/admin/backup/databasePOSTStart a backup run now for a periodic backup task defined on the database.

Parameters:
  • taskId: the periodic backup task to run
  • isFullBackup: run a full backup instead of an incremental one (optional, default true)
  • startTime: schedule the backup for this time instead of running it immediately (optional)
/databases/*/admin/backup/runningGETReturn the operation ID of a periodic backup task's currently running backup, so the caller can track its progress.

Parameters:
  • taskId: the periodic backup task
/databases/*/admin/cdc-sinkPUTAdd or update a CDC (Change Data Capture) sink task for the database.

Parameters:
  • id: the sink task to update (optional, adds a new task when omitted)
/databases/*/admin/cdc-sink/schemaPOSTDiscover and return the source schema for a CDC (Change Data Capture) sink for the database.
/databases/*/admin/cdc-sink/testPOSTTest a CDC (Change Data Capture) sink script for the database.
/databases/*/admin/configuration/clientPUTSet the client configuration for the database.
/databases/*/admin/configuration/studioPUTSet the Studio configuration for the database.
/databases/*/admin/connection-stringsGET, PUT, DELETEGet (GET), add or update (PUT), or remove (DELETE) connection strings for the database.

Parameters:
  • connectionStringName: return only this connection string (GET only, optional)
  • connectionString: name of the connection string to remove (DELETE only, required)
  • type: the connection string type, required for DELETE and when connectionStringName is specified in GET
/databases/*/admin/data-archival/configPOSTConfigure data archival for the database.
/databases/*/admin/debug/periodic-backup/timersGETReturn the periodic backup timers for the database.
/databases/*/admin/documents-compression/configPOSTConfigure documents compression for the database.
/databases/*/admin/etlPUT, RESETAdd or update (PUT) or reset (RESET) an ETL task for the database.
/databases/*/admin/etl/elasticsearch/testPOSTTest an Elasticsearch ETL script for the database.
/databases/*/admin/etl/elasticsearch/test-connectionPOSTTest the connection to an Elasticsearch cluster for the database.
/databases/*/admin/etl/olap/testPOSTTest an OLAP ETL script for the database.
/databases/*/admin/etl/queue/amazonsqs/test-connectionPOSTTest the connection to Amazon SQS for the database.
/databases/*/admin/etl/queue/azurequeuestorage/test-connectionPOSTTest the connection to Azure Queue Storage for the database.
/databases/*/admin/etl/queue/azureservicebus/test-connectionPOSTTest the connection to Azure Service Bus for the database.
/databases/*/admin/etl/queue/kafka/test-connectionPOSTTest the connection to Kafka for the database.
/databases/*/admin/etl/queue/rabbitmq/test-connectionPOSTTest the connection to RabbitMQ for the database.
/databases/*/admin/etl/queue/testPOSTTest a Queue ETL script for the database.
/databases/*/admin/etl/raven/testPOSTTest a RavenDB ETL script for the database.
/databases/*/admin/etl/snowflake/testPOSTTest a Snowflake ETL script for the database.
/databases/*/admin/etl/snowflake/test-connectionPOSTTest the connection to Snowflake for the database.
/databases/*/admin/etl/sql/testPOSTTest a SQL ETL script for the database.
/databases/*/admin/etl/sql/test-connectionPOSTTest the connection to the SQL ETL target for the database.
/databases/*/admin/expiration/configPOSTConfigure document expiration for the database.
/databases/*/admin/featuresPOSTModify the supported features for the database.
/databases/*/admin/indexesPUTCreate or update static indexes for the database.
/databases/*/admin/indexes/disablePOSTDisable an index.
/databases/*/admin/indexes/dumpPOSTDump an index's raw internal data files for the database to a directory on the server, as a background operation.

Parameters:
  • name: the index to dump
  • path: the target directory on the server
/databases/*/admin/indexes/enablePOSTEnable an index.
/databases/*/admin/indexes/optimizePOSTOptimize an index for the database by merging its underlying Lucene segments, as a background operation.

Parameters:
  • name: the index to optimize
/databases/*/admin/indexes/startPOSTResume indexing for the database. With no parameters, all indexing is resumed.

Parameters:
  • name: resume only the specified index (optional)
  • type: resume only indexes of this type, map or map-reduce (optional)
/databases/*/admin/indexes/stopPOSTPause indexing for the database until the server restarts. With no parameters, all indexing is paused.

Parameters:
  • name: pause only the specified index (optional)
  • type: pause only indexes of this type, map or map-reduce (optional)
/databases/*/admin/integrations/postgresql/configPOSTSet the PostgreSQL protocol integration configuration for the database.
/databases/*/admin/integrations/postgresql/server/statusGETGet the status of the PostgreSQL protocol integration for the database.
/databases/*/admin/integrations/postgresql/userPUT, DELETEPUT adds a user, and DELETE removes a user, for the database's PostgreSQL protocol integration.

Parameters:
  • username: the username to remove (required for DELETE)
/databases/*/admin/integrations/postgresql/usersGETGet the list of usernames defined for the database's PostgreSQL protocol integration.
/databases/*/admin/periodic-backupPOSTCreate or update a periodic backup task.
/databases/*/admin/periodic-backup/configGETGet the server's backup configuration options: the local root path, allowed AWS regions, and allowed backup destinations.
/databases/*/admin/pull-replication/generate-certificatePOSTGenerate a self-signed certificate for a pull replication hub, for the database.

Parameters:
  • validMonths: certificate validity in months (optional)
  • validYears: certificate validity in years (optional)
/databases/*/admin/queue-sinkPUTAdd or update a queue sink task for the database.
/databases/*/admin/queue-sink/testPOSTTest a queue sink script for the database and return the result without persisting anything.
/databases/*/admin/rachis/wait-for-index-notificationsPOSTWait until the database has applied cluster (Rachis) state changes up to a specified command index.
/databases/*/admin/recordGETGet the database record (the database's configuration document) for the database.
/databases/*/admin/refresh/configPOSTConfigure document refresh for the database.
/databases/*/admin/restartPOSTRestart the database.
/databases/*/admin/revisionsDELETEDelete revisions of specified documents in the database.
/databases/*/admin/revisions/bin-cleaner/configPOSTConfigure the revisions bin cleaner for the database.
/databases/*/admin/revisions/configPOSTConfigure revisions for the database.
/databases/*/admin/revisions/config/enforcePOSTApply the current revisions configuration to existing documents in the database, as a background operation.
/databases/*/admin/revisions/conflicts/configPOSTConfigure revisions settings for conflicting documents in the database.
/databases/*/admin/revisions/orphaned/adoptPOSTAdopt orphaned revisions in the database, as a background operation.
/databases/*/admin/schema-validation/configPOSTSet the schema validation configuration for the database.
/databases/*/admin/sharding/prefixedPUT, POST, DELETEManage sharding-by-prefix settings for a sharded database. PUT adds a prefix setting and fails if documents already exist with that prefix, POST updates the shard assignments of an existing prefix setting, and DELETE removes a prefix setting and fails if documents exist with that prefix.
/databases/*/admin/sharding/resharding/cleanupPOSTClean up after resharding by migrating documents to their destination shards for the database.
/databases/*/admin/smuggler/importGETImport data into the database from a dump file.

Parameters:
  • file: path to a dump file on the server, requires operator access (one of file or url is required)
  • url: URL to a dump file, requires operator access (one of file or url is required)
/databases/*/admin/smuggler/import-dirGETImport data into the database from all dump files in a directory on the server.

Parameters:
  • dir: the server directory containing the dump files
  • extension: file extension to match (optional, default dump)
  • maxTasks: number of concurrent import tasks (optional, default is half the processor count)
/databases/*/admin/smuggler/import-s3-dirGETImport data into the database from all dump files listed in an S3 directory.

Parameters:
  • url: the S3 directory listing URL
  • maxTasks: number of concurrent import tasks (optional, default is half the processor count)
/databases/*/admin/smuggler/migratePOSTMigrate data into the database from another database platform using an external migrator tool.
/databases/*/admin/smuggler/migrate/ravendbPOSTMigrate data into the database from another RavenDB server.
/databases/*/admin/sortersPUT, DELETEPUT adds or updates custom sorters, and DELETE removes a custom sorter, for the database.
/databases/*/admin/sql-migration/importPOSTImport data into the database from a relational (SQL) database, as a background operation.
/databases/*/admin/sql-migration/schemaPOSTRetrieve the schema (tables and relationships) of a source relational (SQL) database for use when configuring a migration.
/databases/*/admin/sql-migration/testPOSTTest a relational (SQL) database migration for the database and return the result without importing.
/databases/*/admin/storage/manual-flushPOSTManually flush a storage environment of the database to disk.

Parameters:
  • name: the storage environment name
  • type: the storage environment type
/databases/*/admin/storage/manual-syncPOSTManually sync a storage environment of the database to disk.

Parameters:
  • name: the storage environment name
  • type: the storage environment type
/databases/*/admin/studio-tasks/folder-path-optionsPOSTGet available folder or bucket path options for a periodic backup destination (local, S3, Azure, or Google Cloud), for use by Studio path pickers.

Parameters:
  • type: backup destination type (optional, default Local)
  • path: local folder path to list (optional)
  • backupFolder: restrict results to backup folders (optional, default false)
/databases/*/admin/studio-tasks/restartPOSTRestart the database.
/databases/*/admin/tasksDELETEDelete an ongoing task.
/databases/*/admin/tasks/external-replicationPOSTCreate or update an external replication task.
/databases/*/admin/tasks/pull-replication/hubPUTDefine (create or update) a pull replication hub task for the database.
/databases/*/admin/tasks/pull-replication/hub/accessGET, PUT, DELETEManage access to a pull replication hub for the database. GET lists access entries, PUT registers access, and DELETE unregisters access.
/databases/*/admin/tasks/sink-pull-replicationPOSTCreate or update a pull replication sink task for the database.
/databases/*/admin/tasks/statePOSTEnable or disable an ongoing task.
/databases/*/admin/timeseries/configPOSTSet the time series configuration for the database.
/databases/*/admin/timeseries/policyPUT, DELETEPUT adds or updates a time series rollup policy, and DELETE removes a time series policy, for the database.
/databases/*/admin/tombstones/cleanupPOSTForce cleanup of tombstones in the database.
/databases/*/admin/transactions/start-recordingPOSTStart recording the database's transaction commands to a file on the server, as a background operation.
/databases/*/admin/transactions/stop-recordingPOSTStop the in-progress transaction command recording for the database.
/databases/*/admin/validate-unused-idsPOSTValidate the set of unused database IDs supplied for the database.
/databases/*/ai/agentPOSTRun a conversation with an AI agent.

Parameters:
  • agentId: the AI agent identifier
  • conversationId: the conversation identifier
  • streaming: stream the response as Server-Sent Events (optional, default false)
  • changeVector: change vector for optimistic concurrency (optional)
  • debug: enable debug mode override (optional)
  • cancelPendingActionTools: cancel any pending action tool calls before continuing (optional, default false)
/databases/*/ai/agent/conversation/messagesGETGet the messages of an AI agent conversation for the database.

Parameters:
  • conversationId: the conversation identifier
  • pageSize: maximum number of messages to return (optional, default unlimited)
  • detailLevel: level of detail to include in each message (optional)
  • before: return only messages before this date and time (optional)
  • after: return only messages after this date and time (optional, cannot be combined with before)
/databases/*/ai/agent/testPOSTRun a test conversation with an AI agent for the database, without persisting it.

Parameters:
  • conversationId: the conversation identifier (optional, default TestConversation)
  • streaming: stream the response as Server-Sent Events (optional, default false)
/databases/*/analyzersGETGet the custom analyzers defined for the database.
/databases/*/attachmentsGET, PUT, POST, DELETE, HEADGet, store, or delete a document's attachment, or check whether it exists. GET retrieves an attachment from the current version of a document; POST retrieves an attachment using a type and change vector from the request body (for example, from a document revision); PUT stores an attachment; DELETE removes an attachment; HEAD checks whether an attachment exists.

Parameters:
  • id: the document ID
  • name: the attachment name
/databases/*/attachments/bulkPOST, DELETEGet or delete multiple attachments in one request.
/databases/*/bulk_docsPOSTExecute a batch of document commands (a session SaveChanges) in a single transaction.
/databases/*/bulk_insertPOSTStream a large number of documents into the database in a single bulk-insert operation.

Parameters:
  • id: the operation ID
  • skipOverwriteIfUnchanged: skip overwriting a document if the incoming content is unchanged (optional, default false)
/databases/*/cdc-sink/performanceGETPerformance statistics for the database's CDC sink tasks.
/databases/*/cdc-sink/performance/liveGETLive streaming of performance statistics for the database's CDC sink tasks over a WebSocket.
/databases/*/changesGET, DELETEGET: subscribe to the database's Changes API stream over a WebSocket. DELETE: close Changes API connections.
/databases/*/changes/debugGETDebug information about the database's active Changes API connections.
/databases/*/cmpxchgGET, PUT, DELETEGet, create or update, or delete compare-exchange values.
/databases/*/collections/docsGETGet documents from a collection.

Parameters:
  • name: the collection name
  • start: number of documents to skip (optional, default 0)
  • pageSize: maximum number of documents to return (optional, default unlimited)
/databases/*/collections/docs/idsGETGet the IDs of the documents in a collection.

Parameters:
  • name: the collection name
  • start: number of documents to skip (optional, default 0)
  • pageSize: maximum number of IDs to return (optional, default unlimited)
/databases/*/collections/last-change-vectorGETGet the change vector of the last document in a collection.

Parameters:
  • name: the collection name (required)
/databases/*/collections/statsGETStatistics for the database: total counts of documents, tombstones, conflicts, revision documents, attachments, counter entries, and time series segments, plus the document count for each collection.
/databases/*/configuration/clientGETGet the client configuration for the database, falling back to the server-wide client configuration when the database has none or it is disabled.

Parameters:
  • inherit: whether to fall back to the server-wide configuration (optional, default true)
/databases/*/configuration/studioGETGet the Studio configuration for the database. Returns 404 Not Found if none is set.
/databases/*/countersGET, POSTGet (GET) or modify (POST) document counters. POST applies a batch of counter operations from the request body.

Parameters (GET):
  • docId: the document ID (required)
  • counter: counter name to retrieve, repeatable (optional, default: all counters on the document)
  • full: include each node's partial value (optional, default false)
/databases/*/data-archival/configGETGet the data archival configuration for the database.
/databases/*/debug/attachments/hashGETGet the reference count for an attachment content hash.

Parameters:
  • hash: the attachment content hash (required)
/databases/*/debug/attachments/metadataGETGet attachment metadata together with reference counts, for a document.

Parameters:
  • id: the document ID (required)
/databases/*/debug/attachments/missingGETList attachments referenced in document or revision metadata but missing from storage.

Parameters:
  • collection: the collection to scan, or @all_docs for all collections (required)
  • type: Document or Revision, restricts the scan to one type (optional, default: both)
  • start: number of results to skip (optional, default 0)
  • pageSize: maximum number of results to return (optional, default unlimited)
/databases/*/debug/documents/export-all-idsGETExport the IDs of all documents in the database as a downloadable text file.
/databases/*/debug/documents/get-revisionsGETList revisions across all collections in the database (debug view), starting from a given point.

Parameters:
  • start: starting point to list from (optional, default 0)
  • pageSize: maximum number of results to return (optional, default unlimited)
/databases/*/debug/documents/scan-corrupted-idsGETScan the database's documents and revisions for corrupted IDs (wrong escape sequences or unescaped control characters).

Parameters:
  • startEtag: etag to start scanning from (optional, default 0)
  • resultCount: maximum number of results to return (optional, default 1024)
  • maxBatchTimeInSec: maximum scan time in seconds (optional, default 60)
/databases/*/debug/io-metrics/liveGETLive streaming of the database's I/O metrics over a WebSocket.
/databases/*/debug/queries/killPOSTKill a running query, identified either by its client query ID or by index name and query ID.

Parameters:
  • clientQueryId: the client-assigned query ID (optional)
  • indexName: the index the query runs against (required if clientQueryId is not given)
  • id: the server-side query ID (required if clientQueryId is not given)
/databases/*/debug/replication/all-itemsGETList items from the database's outgoing replication stream, as JSON or CSV.

Parameters:
  • etag: etag to start from (optional, default 0)
  • pageSize: maximum number of results to return (optional, default unlimited)
  • type: replication item type to filter by, repeatable (optional)
  • format: json or csv (optional, default json)
  • column: for csv format, the columns to include, repeatable (optional, default: type, etag, change vector, last-modified, transaction marker, size)
/databases/*/debug/sharding/bucketGETInformation about a single sharding bucket in the database: size, document count, last-modified time, and replication items in it. Sharded databases only.

Parameters:
  • bucket: the bucket number (required)
/databases/*/debug/sharding/bucketsGETInformation about the database's sharding buckets, grouped into ranges. Sharded databases only.

Parameters:
  • fromBucket: first bucket to include (optional, default 0)
  • toBucket: last bucket to include (optional, default: unlimited)
  • range: number of buckets grouped per range (optional, default 32768)
/databases/*/debug/storage/all-environments/reportGETA storage report covering all of the database's storage environments (documents and each index).
/databases/*/debug/storage/btree-structureGETThe structure of a named B+Tree in the database's document storage, rendered as an HTML page.

Parameters:
  • name: the tree name (required)
/databases/*/debug/storage/compression-dictionariesGETThe documents-compression dictionaries, in-memory and in-storage, for the database's document storage.
/databases/*/debug/storage/environment/debug-only/pagesGETPage-level ownership information for a storage environment, as plain text. Intended only for debugging RavenDB itself.

Parameters:
  • name: the storage environment name (required)
  • type: the storage environment type, e.g. Documents or Index (required)
/databases/*/debug/storage/environment/free-space-snapshotGETA free-space snapshot for a storage environment.

Parameters:
  • name: the storage environment name (optional, default: the database name)
  • type: the storage environment type (optional, default Documents)
  • hex: return free page numbers in hexadecimal (optional, default true)
/databases/*/debug/storage/environment/reportGETA storage report for a single storage environment.

Parameters:
  • name: the storage environment name (required)
  • type: the storage environment type (required)
  • details: include detailed report data (optional, default false)
  • flat: return the report in flat format (optional, default false)
/databases/*/debug/storage/environment/scratch-buffer-infoGETScratch-buffer-pool information for a storage environment identified by name and type, or for all of the database's storage environments if type is omitted.

Parameters:
  • name: the storage environment name (required)
  • type: the storage environment type (optional)
/databases/*/debug/storage/fst-structureGETThe structure of a named fixed-size tree in the database's document storage, rendered as an HTML page.

Parameters:
  • name: the tree name (required)
/databases/*/debug/storage/treesGETThe variable-size, fixed-size, and embedded fixed-size trees in the database's document storage.
/databases/*/debug/subscriptions/resendGETActive batch IDs and documents queued for resend, for a named subscription.

Parameters:
  • name: the subscription name (required)
/databases/*/docsGET, PUT, POST, PATCH, DELETE, HEADCreate, read, update, delete, or check documents by ID.
/databases/*/docs/classGETGenerate a C# class definition from a document, identified by ID or from the most recently modified document in a collection.

Parameters:
  • id: the document ID (optional if collection is given)
  • collection: the collection to pick the most recent document from (optional if id is given)
  • lang: the target language; only csharp is currently supported (optional, default csharp)
/databases/*/docs/sizeGETGet the storage size of a document.

Parameters:
  • id: the document ID (required)
/databases/*/documents-compression/configGETGet the documents compression configuration for the database.
/databases/*/etl/debug/statsGETDebug statistics (per-transformation statistics and metrics) for the database's ETL tasks.

Parameters:
  • name: ETL task name to filter by, repeatable (optional, default: all tasks)
/databases/*/etl/performanceGETPerformance statistics for the database's ETL tasks.

Parameters:
  • name: ETL task name to filter by, repeatable (optional, default: all tasks)
/databases/*/etl/performance/liveGETLive streaming of performance statistics for the database's ETL tasks over a WebSocket.

Parameters:
  • name: ETL task name to filter by, repeatable (optional, default: all tasks)
/databases/*/etl/retry-batchPOSTForce an ETL process to retry immediately, skipping its fallback wait.

Parameters:
  • name: the ETL process name (required)
/databases/*/expiration/configGETGet the document expiration configuration for the database.
/databases/*/healthcheckGETA lightweight health check for the database.
/databases/*/hilo/nextGETGet the next range of IDs from the HiLo generator.

Parameters:
  • tag: the HiLo document tag (required)
  • lastBatchSize: the size of the last range the client received (optional, default 0)
  • lastRangeAt: when the last range was received (optional)
  • identityPartsSeparator: separator character between the tag and the numeric value (optional, default: the database's identity parts separator)
  • lastMax: the last max value the client saw (optional, default 0)
/databases/*/hilo/returnPUTReturn an unused HiLo ID range.

Parameters:
  • tag: the HiLo document tag (required)
  • end: the end of the range being returned (required)
  • last: the last ID actually used (required)
/databases/*/identity/nextPOSTGet the next value for an identity.

Parameters:
  • name: the identity name (required)
/databases/*/identity/seedPOSTSet the seed value for an identity.

Parameters:
  • name: the identity name (required)
  • value: the seed value (required)
  • force: set the value even if it is lower than the current one (optional, default false)
/databases/*/index/open-faulty-indexPOSTReopen an index that has faulted.

Parameters:
  • name: the index name (required)
/databases/*/indexes/auto/convertGETConvert an auto index into a static C# class or index definition JSON.

Parameters:
  • name: the auto index name (required)
  • outputType: CsharpClass or Json (required)
  • download: return the result as a downloadable file (optional, default false)
/databases/*/indexes/c-sharp-index-definitionGETThe C# form of an index definition.

Parameters:
  • name: the index name (required)
/databases/*/indexes/debugGETDebug information for an index: reduce trees for a map-reduce index, source document IDs, indexed entry fields, or HNSW vector-search graph output, depending on op.

Parameters:
  • name: the index name (required)
  • op: map-reduce-tree, source-doc-ids, entries-fields, or hnsw (required)
  • docId: document IDs to restrict the reduce tree to, repeatable (optional, used with map-reduce-tree)
  • startsWith: prefix filter for source document IDs (optional, used with source-doc-ids)
  • field: the vector field name (required for hnsw)
/databases/*/indexes/finish-rollingPOSTForce completion of a rolling deployment for an index.

Parameters:
  • name: the index name (required)
  • node: the node tag (optional)
/databases/*/indexes/has-changedPOSTWhether a submitted index definition differs from the deployed one.
/databases/*/indexes/historyGETThe change history of an index definition.

Parameters:
  • name: the index name (required)
/databases/*/indexes/last-queriedPOSTLegacy no-op endpoint retained for backward compatibility.
/databases/*/indexes/performance/liveGETLive streaming of indexing performance statistics for the database over a WebSocket.

Parameters:
  • name: index name to filter by, repeatable (optional, default: all indexes)
/databases/*/indexes/progressGETIndexing progress for indexes that are stale or not yet deployed on all nodes.
/databases/*/indexes/replacePOSTReplace an index with its side-by-side version.

Parameters:
  • name: the index name (required)
/databases/*/indexes/set-lockPOSTSet the lock mode of an index.
/databases/*/indexes/set-priorityPOSTSet the priority of an index.
/databases/*/indexes/sourceGETThe source code of an index definition.

Parameters:
  • name: the index name (required)
/databases/*/indexes/stalenessGETWhether an index is stale, and why.

Parameters:
  • name: the index name (required)
/databases/*/indexes/statusGETThe running state of the database's indexes.
/databases/*/indexes/suggest-index-mergeGETSuggestions for merging similar indexes.
/databases/*/indexes/termsGETThe indexed terms for a given index field.

Parameters:
  • name: the index name (required)
  • field: the field name (required)
  • collection: resolve the index dynamically from a collection and field instead of naming it directly (optional)
  • fromValue: return terms starting after this value (optional)
  • pageSize: maximum number of terms to return (optional, default unlimited)
/databases/*/indexes/testPOSTTest a static index definition against sample documents and return its results, without deploying it (testing C# indexes requires admin privileges).
/databases/*/indexes/total-timeGETThe total indexing time and indexing lag for the database's indexes.

Parameters:
  • name: index name to filter by, repeatable (optional, default: all indexes)
/databases/*/indexes/tryPOSTTest a JavaScript index definition against documents and return its results, without deploying it.

Parameters:
  • inputSize: maximum number of documents to test per collection, when no explicit document IDs are given in the request body (optional, default 10)
/databases/*/info/tcpGETThe database's TCP connection information for clients.

Parameters:
  • senderUrl: the requesting node's URL, used to decide whether to return the public or internal cluster TCP URL (optional)
/databases/*/json-patchPATCHApply a JSON Patch to a document.

Parameters:
  • id: the document ID (required)
/databases/*/metricsGETRate and count metrics for the database.
/databases/*/metrics/bytesGETByte-throughput metrics for the database.

Parameters:
  • empty: include metrics with no recorded data (optional, default true)
/databases/*/metrics/putsGETDocument-write metrics for the database.

Parameters:
  • empty: include metrics with no recorded data (optional, default true)
/databases/*/migrate/get-migrated-server-urlsGETThe server URLs that data has been migrated from into this database.
/databases/*/multi_getPOSTExecute several read requests in a single round trip.
/databases/*/notification-center/dismissPOSTDismiss a notification in the database's notification center.

Parameters:
  • id: the notification ID (required)
  • forever: dismiss it permanently instead of just for the current session (optional, default false)
/databases/*/notification-center/postponePOSTPostpone a notification in the database's notification center.

Parameters:
  • id: the notification ID (required)
  • timeInSec: how long to postpone it for, in seconds; 0 postpones it indefinitely (required)
/databases/*/notification-center/statsGETDatabase-wide statistics used by the notification center: document, conflict, index, stale-index, indexing-error, ETL/AI/CDC-sink-task-error counts, per-collection document counts, and revision count.
/databases/*/notification-center/watchGETOpen a WebSocket connection to stream the database's stored notifications and active-operation status changes in real time.
/databases/*/operationsGETThe database's operations.

Parameters:
  • id: a specific operation ID to return (optional, default: all operations)
/databases/*/operations/killPOSTKill a running database operation, identified by its operation ID.

Parameters:
  • id: the ID of the operation to kill (required)
/databases/*/operations/next-operation-idGETA new unique operation ID for the database, used to track a long-running operation.
/databases/*/operations/stateGETThe state of a database operation, identified by its operation ID.

Parameters:
  • id: the ID of the operation (required)
/databases/*/queriesGET, POST, PATCH, DELETERun an RQL query (GET/POST), patch by query (PATCH), or delete by query (DELETE).
/databases/*/queries/testPATCHTest a patch script against one document without applying it, returning the patch status and the original and modified document.

Parameters:
  • id: the ID of the document to test the patch against (required)
/databases/*/queue-sink/performance/liveGETStream live performance statistics for the database's queue sink tasks over a WebSocket.

Parameters:
  • name: one or more queue sink task names to report on (optional, reports on all tasks if omitted)
/databases/*/refresh/configGETThe database's document refresh configuration.
/databases/*/replication/active-connectionsGETThe database's active incoming and outgoing replication connections.
/databases/*/replication/conflictsGETThe database's replication conflicts, or the conflicts for one document.

Parameters:
  • docId: return conflicts for this document only (optional)
/databases/*/replication/conflicts/solverGETThe database's conflict resolver configuration.
/databases/*/replication/heartbeatPOSTNo-op. Returns immediately with no content.
/databases/*/replication/lastEtagGETReplication source information, including the last replicated document etag, for a legacy replication source.
/databases/*/replication/performanceGETPerformance statistics for the database's replication.
/databases/*/replication/performance/liveGETStream live replication performance statistics for the database over a WebSocket.
/databases/*/replication/pulses/liveGETStream the database's live replication pulse events over a WebSocket.
/databases/*/replication/replicateAttachmentsPOSTReceives attachments from a legacy replication source and imports them into the database.
/databases/*/replication/replicateDocsPOSTReceives documents from a legacy replication source and imports them into the database.
/databases/*/replication/tombstonesGETThe replication tombstones for the database.
/databases/*/revisionsGETGet a document's revisions, by change vector or by document ID with paging.

Parameters:
  • id: the document ID, used when changeVector is not specified
  • changeVector: one or more revision change vectors to fetch instead of using id (optional)
  • before: return the single revision as of this date and time, instead of a page of revisions (optional)
  • metadataOnly: return only revision metadata (optional, default false)
/databases/*/revisions/binGETGet the revisions of deleted documents from the revisions bin.
/databases/*/revisions/bin-cleaner/configGETThe database's revisions bin cleaner configuration.
/databases/*/revisions/collections/statsGETThe number of revisions per collection, and the total revision count, for the database.
/databases/*/revisions/configGETThe database's revisions configuration.
/databases/*/revisions/conflicts/configGETThe database's conflict revisions configuration.
/databases/*/revisions/countGETThe number of revisions for a document.

Parameters:
  • id: the document ID (required)
/databases/*/revisions/resolvedGETRevisions of documents whose conflicts were resolved, since a given time.

Parameters:
  • since: return conflicts resolved after this time (optional)
  • take: maximum number of revisions to return (optional, default 1024)
/databases/*/revisions/revertPOSTRevert the database's documents to their state at a given time.
/databases/*/revisions/revert/docsPOSTRevert specific documents to a given revision.
/databases/*/revisions/sizeGETThe size details of a specific document revision, identified by its change vector.

Parameters:
  • changeVector: the change vector of the revision to measure (required)
/databases/*/schema-validation/configGETThe database's schema validation configuration.
/databases/*/schema-validation/validatePOSTValidate a collection's documents against a supplied schema validation definition.
/databases/*/side-by-side-indexesPUTNo-op. Returns immediately with no content.
/databases/*/smuggler/exportPOSTExport the database's data to a file.
/databases/*/smuggler/importPOSTImport data into the database from an export file.
/databases/*/smuggler/import/csvPOSTImport documents from a CSV file.

Parameters:
  • collection: the collection to import into (optional)
/databases/*/smuggler/validate-optionsPOSTValidate a set of smuggler import/export options: checks that the file name is valid and the transform script compiles.
/databases/*/sortersGETThe custom sorters defined for the database.
/databases/*/stats/detailedGETDetailed database statistics.
/databases/*/stats/essentialGETEssential, lightweight database statistics.
/databases/*/streams/docsGETStream documents without loading them all into memory.
/databases/*/streams/queriesGET, POST, HEADStream the results of an RQL query (GET/POST). HEAD is a no-op that returns no content.
/databases/*/streams/timeseriesGETStream time series data.
/databases/*/studio-tasks/indexes/configuration/defaultsGETReturns the default index configuration values for the database, used by Studio when creating an index.
/databases/*/studio-tasks/remote-attachments/configurationGETReturns the remote attachments configuration for the database.
/databases/*/studio-tasks/suggest-conflict-resolutionGETReturns a suggested merged resolution (document and metadata) for a conflicted document in the database.

Parameters:
  • docId: ID of the conflicted document
/databases/*/studio/collections/docsDELETEDeletes documents of a collection in the database, used by Studio.
/databases/*/studio/collections/fieldsGETReturns the document fields found in a collection of the database, used by Studio.
/databases/*/studio/collections/previewGETReturns a preview page of documents for Studio's collection view of the database.
/databases/*/studio/footer/statsGETReturns the summary statistics shown in the Studio footer for the database.
/databases/*/studio/index-fieldsPOSTCompiles the map function sent in the request body and returns the output fields the index would emit for the database (empty array on compilation failure).

Parameters:
  • Map (request body): the index map function
/databases/*/studio/index-typePOSTDetects and returns the index type and index source type of the index definition sent in the request body.
/databases/*/studio/indexes/errors-countGETReturns the number of indexing errors for the database's indexes, used by Studio.

Parameters:
  • name: one or more index names to filter to (optional, returns all indexes if omitted)
/databases/*/studio/license/limits-usageGETReturns the database's current usage against the license limits, used by Studio.
/databases/*/studio/revisions/idsGETReturns revision IDs by prefix for the database, used by Studio.
/databases/*/studio/revisions/previewGETReturns a preview page of document revisions for Studio's revisions view of the database.
/databases/*/studio/sample-dataPOSTCreates the sample data set in the database. Fails if the database already contains documents.

Parameters:
  • operateOnTypes: which data types to include (optional, includes all types by default)
/databases/*/studio/sample-data/classesGETReturns the C# classes for the sample data model, used by Studio.
/databases/*/studio/tasks/embeddingsGETReturns the list of embeddings generation tasks defined for the database, used by Studio.
/databases/*/studio/validate-schemaPOSTValidates a document sent in the request body against the database's schema.
/databases/*/subscription-tasksDELETEDelete a subscription task.

Parameters:
  • id: the task ID (required)
  • taskName: the task name (optional)
  • type: the task type; must be Subscription (required)
/databases/*/subscription-tasks/statePOSTEnable or disable a subscription task.

Parameters:
  • key: the task ID (required)
  • disable: disable the task if true, enable it if false (optional, default true)
  • taskName: the task name (optional)
  • type: the task type; must be Subscription (required)
/databases/*/subscriptions/connection-detailsGETConnection details for a data subscription.

Parameters:
  • name: the subscription name (required)
/databases/*/subscriptions/dropPOSTDrop the current connection of a data subscription.

Parameters:
  • id: the subscription ID (optional, alternative to name)
  • name: the subscription name (optional, alternative to id)
  • workerId: drop only the connection with this worker ID (optional, drops all connections if omitted)
/databases/*/subscriptions/performance/liveGETLive stream of subscription performance statistics for the database.
/databases/*/subscriptions/stateGETThe state of a data subscription.

Parameters:
  • name: the subscription name (required)
/databases/*/subscriptions/tryPOSTTest a data subscription without acknowledging progress.

Parameters:
  • timeLimit: maximum time in seconds to collect results (optional, default 15)
/databases/*/subscriptions/updatePOSTUpdate a data subscription's definition.
/databases/*/taskGETGet a single ongoing task by ID or name.

Parameters:
  • key: the task ID (required unless taskName is given)
  • taskName: the task name (required if key is omitted)
  • type: the ongoing task type (required)
/databases/*/tasks/errorsGET, DELETERecent errors for the database's ongoing tasks. GET lists them; DELETE clears them.

Parameters:
  • name: one or more task names to clear errors for, DELETE only (optional, clears all tasks' errors if omitted)
  • type: the task category the name values belong to, DELETE only (required if name is given)
/databases/*/tasks/pull-replication/hubGETInformation about a specific pull replication hub task and its current incoming connections.

Parameters:
  • key: the hub task ID (required)
/databases/*/timeseriesGET, POSTGet (GET) or append (POST) a document's time series data.
/databases/*/timeseries/configGETReturns the time series configuration for the database.
/databases/*/timeseries/debug/segments-summaryGETReturns a summary of the stored time series segments for a document.

Parameters:
  • docId: the document ID (required)
  • name: the time series name (required)
  • from: start of the range (optional)
  • to: end of the range (optional)
/databases/*/timeseries/names/configPOSTConfigures the named time series values for the database.
/databases/*/timeseries/rangesGET, POSTReturns time series range data for one or more named time series on a document. GET reads the document ID, names, and date ranges from the query string; POST reads a JSON body listing ranges per document ID, so it can return ranges for multiple documents in one call.

Parameters:
  • docId: document ID (GET only)
  • name: time series name, repeatable (GET only)
  • from / to: range start and end per name (GET only)
  • start: number of results to skip (optional, default 0)
  • pageSize: maximum number of results to return (optional, default unlimited)
  • includeDocument: include the parent document (optional, default false, GET only)
  • includeTags: include time series tags (optional, default false, GET only)
  • full: include per-node values for incremental time series entries (optional, default false)
/databases/*/timeseries/statsGETReturns each time series' entry count, start date, and end date for a document.

Parameters:
  • docId: the document ID
/databases/*/transactions/replayPOSTReplays a recorded transaction commands file, uploaded as multipart form data, against the database and returns the number of commands executed.

Parameters:
  • operationId: ID to track the operation (optional, default: a new ID is generated)
/databases/*/transformers/$PUT, DELETELegacy transformer endpoint retained for backward compatibility; performs no operation.
/debug/info-package/analyzer/cluster/logGETReturns a node's cluster log entry from a previously uploaded debug package.

Parameters:
  • packageId: ID of the uploaded debug package
  • nodeTag: node whose data is returned
/debug/info-package/analyzer/cluster/observer/decisionsGETReturns the cluster observer decisions from a previously uploaded debug package.

Parameters:
  • packageId: ID of the uploaded debug package
/debug/info-package/analyzer/cluster/topologyGETReturns the cluster topology from a previously uploaded debug package.

Parameters:
  • packageId: ID of the uploaded debug package
  • nodeTag: node whose topology is returned (optional; defaults to the first node that has topology data)
/debug/info-package/analyzer/databases/configuration/settingsGETReturns a database's configuration settings from a previously uploaded debug package.

Parameters:
  • packageId: ID of the uploaded debug package
  • nodeTag: node whose data is returned
  • name: database name
/debug/info-package/analyzer/databases/indexesGETReturns a database's index definitions from a previously uploaded debug package.

Parameters:
  • packageId: ID of the uploaded debug package
  • nodeTag: node whose data is returned
  • name: database name
/debug/info-package/analyzer/databases/indexes/errorsGETReturns a database's index errors from a previously uploaded debug package.

Parameters:
  • packageId: ID of the uploaded debug package
  • nodeTag: node whose data is returned
  • name: database name
/debug/info-package/analyzer/databases/indexes/performanceGETReturns a database's indexing performance data from a previously uploaded debug package.

Parameters:
  • packageId: ID of the uploaded debug package
  • nodeTag: node whose data is returned
  • name: database name
/debug/info-package/analyzer/databases/indexes/statsGETReturns a database's index statistics from a previously uploaded debug package.

Parameters:
  • packageId: ID of the uploaded debug package
  • nodeTag: node whose data is returned
  • name: database name
/debug/info-package/analyzer/databases/overviewGETReturns a database's overview, including detected issues, from a previously uploaded debug package.

Parameters:
  • packageId: ID of the uploaded debug package
  • nodeTag: node whose data is returned
  • name: database name
/debug/info-package/analyzer/databases/recordGETReturns a database's database record from a previously uploaded debug package.

Parameters:
  • packageId: ID of the uploaded debug package
  • nodeTag: node whose data is returned
  • name: database name
/debug/info-package/analyzer/databases/statsGETReturns a database's statistics from a previously uploaded debug package.

Parameters:
  • packageId: ID of the uploaded debug package
  • nodeTag: node whose data is returned
  • name: database name
/debug/info-package/analyzer/databases/tasksGETReturns a database's ongoing tasks from a previously uploaded debug package.

Parameters:
  • packageId: ID of the uploaded debug package
  • nodeTag: node whose data is returned
  • name: database name
/debug/info-package/analyzer/memoryGETReturns a node's memory information from a previously uploaded debug package.

Parameters:
  • packageId: ID of the uploaded debug package
  • nodeTag: node whose data is returned
/debug/info-package/analyzer/networkGETReturns a node's network information from a previously uploaded debug package.

Parameters:
  • packageId: ID of the uploaded debug package
  • nodeTag: node whose data is returned
/debug/info-package/analyzer/removeDELETERemoves a previously uploaded debug package analysis from the server.

Parameters:
  • packageId: ID of the uploaded debug package to remove
/debug/info-package/analyzer/summaryGETReturns the analysis summary of a previously uploaded debug package.

Parameters:
  • packageId: ID of the uploaded debug package
/debug/info-package/analyzer/summary/nodeGETReturns the analysis summary for a single node of a previously uploaded debug package.

Parameters:
  • packageId: ID of the uploaded debug package
  • nodeTag: node whose summary is returned
/debug/info-package/analyzer/threads/runawayGETReturns a node's runaway threads information from a previously uploaded debug package.

Parameters:
  • packageId: ID of the uploaded debug package
  • nodeTag: node whose data is returned
/debug/info-package/analyzer/threads/stack-traceGETReturns a node's thread stack traces from a previously uploaded debug package.

Parameters:
  • packageId: ID of the uploaded debug package
  • nodeTag: node whose data is returned
/debug/info-package/analyzer/uploadPOSTUploads a debug package (a zip archive sent in the request body), analyzes it, and returns the analysis summary.
/debug/is-loadedGETReturns whether the named database is loaded on the server.

Parameters:
  • name: database name
/debug/queries/running/liveGETStreams currently running queries, over a WebSocket connection, across the databases the user is allowed to access.
/debug/routesGETLists every route the server exposes, grouped into Debug and Production arrays; each entry gives the route path and its HTTP methods.
/debug/sharding/find/bucketGETReturns the bucket and shard number that a document ID maps to in a sharded database.

Parameters:
  • id: the document ID (required)
  • name: the sharded database name (optional)
/eula/$GETServes the static files for the license agreement (EULA) page. Redirects to Studio if the EULA has already been accepted.
/eula/index.htmlGETServes the license agreement (EULA) page. Redirects to Studio if the EULA has already been accepted.
/favicon.icoGETServes the favicon icon file.
/info/remote-task/tcpGETReturns the server's TCP connection information and certificates for an external remote-task connection, such as a replication sink.

Parameters:
  • remote-task: the remote task name (required)
  • database: the database name (required)
  • verify-database: verify that the database exists (optional, default false)
  • tag: the connection tag (optional)
/info/remote-task/topologyGETReturns the URLs of the nodes responsible for a pull replication remote task.

Parameters:
  • database: the database name (required)
  • groupId: the database group ID (required)
  • remote-task: the remote task name (required)
  • tag: the connection tag (optional)
/info/tcpGETReturns the server's TCP connection information and certificates.
/license/configurationGETReturns the license configuration settings that control whether the license can be renewed, activated, or force-updated.
/license/eulaGETReturns the RavenDB license agreement (EULA) text.
/license/free/downloadPOSTDownloads a free license using an email address and verification code. Available only while the server is in setup mode.
/license/free/send-verification-codePOSTSends a verification code to an email address to obtain a free license. Available only while the server is in setup mode.
/license/limits-usageGETReturns the cluster-wide license limits usage: the number of static indexes, auto indexes, custom sorters, analyzers, and subscriptions across all databases.
/license/statusGETReturns the current license status.
/license/supportGETReturns the license support status.
/monitoring/snmpGETReturns the SNMP value for a single OID (object identifier).

Parameters:
  • oid: the object identifier to read (required)
/monitoring/snmp/bulkGET, POSTReturns SNMP values for multiple OIDs. The GET method reads the identifiers from the oid query string; the POST method reads them from an OIDs array in the request body.
/monitoring/snmp/mibGETReturns the RavenDB SNMP MIB definition as a downloadable file.

Parameters:
  • includeServer: include server metrics (optional, default true)
  • includeCluster: include cluster metrics (optional, default false)
  • includeDatabases: include database metrics (optional, default false)
/monitoring/snmp/oidsGETReturns the SNMP OID mappings for the server, cluster, and databases.
/operations/stateGETReturns the state of a server-level or database-level operation.

Parameters:
  • id: the operation ID (required)
/periodic-backupGETReturns the periodic backup configuration of a task for a database.

Parameters:
  • name: the database name (required)
  • taskId: the backup task ID (required)
/periodic-backup/statusGETReturns the status of a periodic backup task for a database.

Parameters:
  • name: the database name (required)
  • taskId: the backup task ID (required)
  • type: status source, Cluster or Local (optional, default Cluster)
/rachis/waitforGETWaits until the cluster has processed the Raft command with the specified index.

Parameters:
  • index: the Raft command index to wait for (required)
/secrets/generateGETGenerates and returns a new random 256-bit secret key, Base64-encoded, for use in database encryption.
/server/notification-center/dismissPOSTDismisses a server notification. When forever is true, the notification is postponed indefinitely instead.

Parameters:
  • id: the notification ID (required)
  • forever: dismiss the notification permanently (optional)
/server/notification-center/postponePOSTPostpones a server notification for a given number of seconds. A value of 0 postpones it indefinitely.

Parameters:
  • id: the notification ID (required)
  • timeInSec: postponement duration in seconds (required)
/server/notification-center/watchGETOpens a WebSocket connection that streams server notifications and active operation updates.
/setup/aliveGETReturns an empty successful response, used to check that the server is reachable during setup.
/setup/continuePOSTContinues the cluster setup on this node from an uploaded setup package. Available only while the server is in setup mode.
/setup/continue/extractPOSTExtracts node information (tags and server URLs) from an uploaded setup zip package. Available only while the server is in setup mode.
/setup/continue/unsecuredPOSTContinues the unsecured cluster setup on this node. Available only while the server is in setup mode.
/setup/dns-n-certPOSTProxies a DNS and certificate request to the RavenDB domain registration service during setup. Available only while the server is in setup mode.

Parameters:
  • action: the request action, claim, user-domains, or check-availability (required)
/setup/finishPOSTCompletes the setup wizard and restarts the server. Available only while the server is in setup mode.
/setup/hostsPOSTValidates an uploaded server certificate and returns its common name (CN) and alternative names. Available only while the server is in setup mode.
/setup/ipsGETReturns the machine name and the available network interfaces with their IP addresses. Available only while the server is in setup mode.
/setup/letsencryptPOSTSets up the server with a Let's Encrypt certificate and returns the settings package. Available only while the server is in setup mode.
/setup/letsencrypt/agreementGETReturns the URL of the Let's Encrypt terms of service for the given email address. Available only while the server is in setup mode.

Parameters:
  • email: the email address for the agreement (required)
/setup/parametersGETReturns setup parameters detected for the environment, such as a fixed server port and whether the server runs on Docker, Azure, AWS, or POSIX. Available only while the server is in setup mode.
/setup/populate-ipsPOSTResolves the IP addresses of the provided domains and subdomains under a root domain. Available only while the server is in setup mode.

Parameters:
  • rootDomain: the root domain (required)
/setup/securedPOSTSets up the server in secured mode using a provided certificate and returns the settings package. Available only while the server is in setup mode.
/setup/unsecured/packagePOSTSets up the server in unsecured mode and returns the settings package. Available only while the server is in setup mode.
/setup/user-domainsPOSTRetrieves the user's registered domains from the RavenDB domain registration service using the supplied license. Available only while the server is in setup mode.
/sortersGETReturns the server-wide custom sorters defined on the server.
/studio-tasks/admin/migrator-pathGETReturns whether a data migrator path is defined in the server configuration.
/studio-tasks/ai/modelsPOSTReturns the available AI models for a given AI connector (OpenAI, Google, Azure OpenAI, or Ollama) using the provided connection settings.
/studio-tasks/bootstrapGETReturns the certificate expiration threshold, in days, that Studio preloads from the server configuration.
/studio-tasks/convert-to-json-schemaPOSTConverts a sample JSON object provided in the request body into a JSON schema.

Parameters:
  • type: the schema type (optional)
/studio-tasks/databasesGETReturns the list of databases for Studio.

Parameters:
  • name: return only the named database (optional)
  • start: number of results to skip (optional, default 0)
  • pageSize: number of results to return (optional, default unlimited)
/studio-tasks/databases/stateGETReturns the state of the databases for Studio.

Parameters:
  • name: return only the named database's state (optional)
  • start: number of results to skip (optional, default 0)
  • pageSize: number of results to return (optional, default unlimited)
/studio-tasks/formatPOSTFormats an index expression provided in the request body.
/studio-tasks/is-valid-nameGETValidates a name for a database, index, script, or Elasticsearch index.

Parameters:
  • type: the item type to validate (required)
  • name: the name to validate (required)
  • dataPath: the data path, used when validating a database name (optional)
/studio-tasks/next-cron-expression-occurrenceGETReturns the next occurrence of a given cron expression. If taskId, database, and isFull are all provided, computes the occurrence relative to that backup task's last full or incremental backup time instead of the current time.

Parameters:
  • expression: the cron expression (required)
  • taskId: the backup task ID, required together with database and isFull (optional)
  • database: the database name, required together with taskId and isFull (optional)
  • isFull: true to use the task's last full backup time or false for its last incremental backup time as the base time, required together with taskId and database (optional)
/studio-tasks/periodic-backup/test-credentialsPOSTTests the connection credentials for a backup destination (Amazon S3, Amazon Glacier, Azure, Google Cloud, or FTP) using settings from the request body.

Parameters:
  • type: the backup destination type (required)
/studio/$GETServes the Studio static files.
/studio/feedbackPOSTSends user feedback from Studio to RavenDB.
/studio/index.htmlGETServes the Studio entry page. Redirects to the two-factor authentication page or the setup wizard depending on the server state.
/studio/upgrade-infoGETReturns information about newer RavenDB versions available for upgrade.

Parameters:
  • start: number of results to skip (optional)
  • pageSize: number of results to return (optional)
/threads-info/watchGETOpens a WebSocket connection that streams information about the server's threads.
/topologyGETReturns the database topology that a client uses to route its requests.

Parameters:
  • name: the database name (required)
  • applicationIdentifier: the client application identifier (optional)
  • private: return the private topology (optional, default false)
  • includePromotables: include promotable nodes (optional, default false)
/wizard/$GETServes the setup wizard static files. Redirects to the corresponding Studio file if the server is already configured.
/wizard/index.htmlGETServes the setup wizard entry page. Redirects to Studio if the server is already configured.