# HydraDB SDK ## Docs - [Introduction](https://cortex-e852fafe-auto-update-openapi-6a9e3873a7492d091ac8c1f.mintlify.site/get-started/v2/introduction.md): Welcome to HydraDB. The unified context substrate for AI. - [Core Concepts](https://cortex-e852fafe-auto-update-openapi-6a9e3873a7492d091ac8c1f.mintlify.site/get-started/v2/core-concepts.md): A tour of the five primitives that make HydraDB. - [Quickstart](https://cortex-e852fafe-auto-update-openapi-6a9e3873a7492d091ac8c1f.mintlify.site/get-started/v2/quickstart.md): Build your first working query in five minutes. - [Knowledge](https://cortex-e852fafe-auto-update-openapi-6a9e3873a7492d091ac8c1f.mintlify.site/essentials/v2/knowledge.md): What Knowledge is, how it differs from Memories, and how to ingest it correctly. - [Memories](https://cortex-e852fafe-auto-update-openapi-6a9e3873a7492d091ac8c1f.mintlify.site/essentials/v2/memories.md): How to use Memories to personalize responses with user-specific context. - [App Sources](https://cortex-e852fafe-auto-update-openapi-6a9e3873a7492d091ac8c1f.mintlify.site/essentials/v2/app-sources.md): How to ingest Slack, Gmail, Jira, Notion, CRM, and other app data using the field-based app-source model. - [Connectors](https://cortex-e852fafe-auto-update-openapi-6a9e3873a7492d091ac8c1f.mintlify.site/essentials/v2/connectors.md): How HydraDB connectors continuously sync external app data into the knowledge store. - [Query](https://cortex-e852fafe-auto-update-openapi-6a9e3873a7492d091ac8c1f.mintlify.site/essentials/v2/query.md): How HydraDB retrieves the right context for each query - Knowledge, Memories, and the context graph, all behind a single /query endpoint. - [Scoping using metadata](https://cortex-e852fafe-auto-update-openapi-6a9e3873a7492d091ac8c1f.mintlify.site/essentials/v2/metadata.md): How HydraDB uses metadata to scope query results with schema-backed fields, free-form additional metadata, source metadata edits, and exact metadata filters. - [Access Control](https://cortex-e852fafe-auto-update-openapi-6a9e3873a7492d091ac8c1f.mintlify.site/essentials/v2/access-control.md): Restrict who can retrieve a document. Declare permissions yourself, or let connectors capture them from the source app. - [How to Use API Results](https://cortex-e852fafe-auto-update-openapi-6a9e3873a7492d091ac8c1f.mintlify.site/essentials/v2/api-results.md): Turn a query response into an LLM prompt. - [Architecture](https://cortex-e852fafe-auto-update-openapi-6a9e3873a7492d091ac8c1f.mintlify.site/essentials/v2/architecture.md): How HydraDB moves content from ingestion to indexed query, and where databases, metadata, graph context, and retrieval fit together. - [Multi tenancy](https://cortex-e852fafe-auto-update-openapi-6a9e3873a7492d091ac8c1f.mintlify.site/essentials/v2/multi-tenant.md): How HydraDB scopes data using databases and collections, and how scoping affects writes and query. - [Glossary](https://cortex-e852fafe-auto-update-openapi-6a9e3873a7492d091ac8c1f.mintlify.site/essentials/v2/glossary.md): The names HydraDB uses for each scope, and the deprecated aliases you may still see. - [Context Graphs](https://cortex-e852fafe-auto-update-openapi-6a9e3873a7492d091ac8c1f.mintlify.site/essentials/v2/context-graphs.md): How HydraDB models relationships between chunks using triplets to improve query quality. - [Bring Your Own Graph](https://cortex-e852fafe-auto-update-openapi-6a9e3873a7492d091ac8c1f.mintlify.site/essentials/v2/bring-your-own-graph.md): Supply your own entities and relations for a document and skip LLM graph extraction. - [Bring Your Own Graph (BYOG)](https://cortex-e852fafe-auto-update-openapi-6a9e3873a7492d091ac8c1f.mintlify.site/essentials/v2/graph-collections-byog.md): BYOG - full Cypher access to graph collections you own end-to-end. - [Semantic Search & Retrieval](https://cortex-e852fafe-auto-update-openapi-6a9e3873a7492d091ac8c1f.mintlify.site/essentials/v2/semantic-search.md): How semantic, keyword bm25, graph, and metadata signals work together in HydraDB query. - [Webhooks](https://cortex-e852fafe-auto-update-openapi-6a9e3873a7492d091ac8c1f.mintlify.site/essentials/v2/webhooks.md): Receive indexing status events when ingested content finishes processing. - [Claude Code](https://cortex-e852fafe-auto-update-openapi-6a9e3873a7492d091ac8c1f.mintlify.site/plugins/claude-code.md): HydraDB plugin for Claude Code. Persistent memory and contextual awareness across sessions and projects. - [HydraDB MCP](https://cortex-e852fafe-auto-update-openapi-6a9e3873a7492d091ac8c1f.mintlify.site/plugins/mcp.md): MCP (Model Context Protocol) server for [HydraDB](https://hydradb.com). Provides tools for storing, recalling, and managing memories with knowledge-graph enriched context. - [HydraDB CLI](https://cortex-e852fafe-auto-update-openapi-6a9e3873a7492d091ac8c1f.mintlify.site/plugins/cli.md): Agent-friendly command line interface for HydraDB. Query context, ingest knowledge and memories, and inspect stored data from the terminal. - [OpenClaw](https://cortex-e852fafe-auto-update-openapi-6a9e3873a7492d091ac8c1f.mintlify.site/plugins/openclaw.md): HydraDB plugin for OpenClaw. Automatically captures conversations, recalls relevant context with knowledge-graph connections, and injects them before every AI turn. - [HydraDB Agent Integration Guide](https://cortex-e852fafe-auto-update-openapi-6a9e3873a7492d091ac8c1f.mintlify.site/AGENTS.md): LLM-facing reference for building against the current HydraDB docs, API, SDKs, and cookbooks. - [Introduction](https://cortex-e852fafe-auto-update-openapi-6a9e3873a7492d091ac8c1f.mintlify.site/cookbooks/v2/index.md): Production-ready guides for building AI agents with HydraDB. - [Build your own Glean with HydraDB](https://cortex-e852fafe-auto-update-openapi-6a9e3873a7492d091ac8c1f.mintlify.site/cookbooks/v2/glean-clone.md): Learn how to build a comprehensive workplace search and AI assistant platform using HydraDB APIs. This guide covers data ingestion, retrieval, and app-layer answer generation across multiple data sources. - [AI Chief of Staff](https://cortex-e852fafe-auto-update-openapi-6a9e3873a7492d091ac8c1f.mintlify.site/cookbooks/v2/ai-chief-of-staff.md): “Quick-start guide to building an AI Chief of Staff with HydraDB using the TypeScript SDK. Register workspace functions as knowledge objects and let any agent ask 'What should I do?' to receive a structured, personalized execution plan. For the full production guide with Python, multi-step planning,… - [AI LinkedIn: People search in Natural Language](https://cortex-e852fafe-auto-update-openapi-6a9e3873a7492d091ac8c1f.mintlify.site/cookbooks/v2/ai-linkedin-recruiter.md): Learn how to build an intelligent recruiting platform that understands natural language queries like 'find me someone who has 5+ years of experience in machine learning and has worked at Apple before' using HydraDB's AI search capabilities. - [AI Travel Planner](https://cortex-e852fafe-auto-update-openapi-6a9e3873a7492d091ac8c1f.mintlify.site/cookbooks/v2/ai-travel-planner.md): Learn how to build an intelligent travel planning platform that understands natural language queries and provides personalized recommendations using HydraDB's AI search and memory capabilities. - [Cursor for Docs](https://cortex-e852fafe-auto-update-openapi-6a9e3873a7492d091ac8c1f.mintlify.site/cookbooks/v2/cookbook-01-build-cursor-for-docs.md): Go from zero to a production AI assistant that answers 'why was this built this way?' - in four phases. Start with one file and a real search query. End with a FastAPI backend that ingests GitHub, PRs, Slack, and RFCs, then generates GPT-4o answers grounded in your codebase. Every endpoint in this g… - [AI Customer Support Agent with Memory](https://cortex-e852fafe-auto-update-openapi-6a9e3873a7492d091ac8c1f.mintlify.site/cookbooks/v2/customer-support-agent.md): A support agent that never forgets. Ingest help docs, past ticket resolutions, and every conversation turn into HydraDB. Every response is personalized using per-user memory - the agent knows the customer's plan, their past issues, their preferences, and what already failed before it starts typing. - [Internal IT Support Agent](https://cortex-e852fafe-auto-update-openapi-6a9e3873a7492d091ac8c1f.mintlify.site/cookbooks/v2/cookbook-04-build-notion-ai.md): Ingest your entire workspace - Notion, Confluence, Slack - into HydraDB and build a conversational interface that understands relationships between documents. Answer 'why did we decide X?' using HydraDB's context graph. Every endpoint in this guide is real and copy-paste ready. - [AI Competitive Intelligence Agent](https://cortex-e852fafe-auto-update-openapi-6a9e3873a7492d091ac8c1f.mintlify.site/cookbooks/v2/competitive-intelligence-agent.md): Continuously ingest competitor press releases, job postings, customer reviews, and earnings transcripts into HydraDB. Answer 'What is Competitor X doing right now?' and 'How has their messaging shifted over the last 6 months?' with full temporal context. Every API call in this guide is real and veri… - [AI Chief of Staff - Function Routing](https://cortex-e852fafe-auto-update-openapi-6a9e3873a7492d091ac8c1f.mintlify.site/cookbooks/v2/hydradb-cookbook-06.md): Build an AI Chief of Staff that takes real actions across your workspace using HydraDB function routing. Register every callable function as a knowledge object in HydraDB. Any agent or user can say 'prepare for tomorrow's board meeting' and receive a structured execution plan. - [Perplexity for Internal Knowledge](https://cortex-e852fafe-auto-update-openapi-6a9e3873a7492d091ac8c1f.mintlify.site/cookbooks/v2/internal-search-perplexity.md): Ingest Slack, Gmail, Confluence, GitHub, and Linear into one HydraDB database. Ask any question in natural language and get a cited, synthesized answer drawing from across all your company's knowledge - including 'what led to the decision to sunset Project X?' with full decision provenance. - [AI Onboarding Agent](https://cortex-e852fafe-auto-update-openapi-6a9e3873a7492d091ac8c1f.mintlify.site/cookbooks/v2/ai-onboarding-agent.md): Go from zero to a working onboarding agent in three phases. Upload decision logs, org charts, meeting notes, and product specs into HydraDB. New hires ask 'why did we choose Postgres?' or 'who owns the payments service?' and get answers from real company context - not generic LLM guesses. Every API… - [AI Financial Analyst with Memory](https://cortex-e852fafe-auto-update-openapi-6a9e3873a7492d091ac8c1f.mintlify.site/cookbooks/v2/cookbook-10-ai-financial-analyst.md): Upload earnings PDFs, internal metrics, and board memos into HydraDB. Ask trend questions across quarters, get temporally-aware answers, and surface the exact clause, figure, or narrative shift - not a generic summary. - [API Reference](https://cortex-e852fafe-auto-update-openapi-6a9e3873a7492d091ac8c1f.mintlify.site/api-reference/v2/index.md): Single reference to all HydraDB endpoints - [SDKs – Python and Node](https://cortex-e852fafe-auto-update-openapi-6a9e3873a7492d091ac8c1f.mintlify.site/api-reference/v2/sdks.md): Official Python and TypeScript/Node.js SDKs for the HydraDB API. - [Databases - Overview](https://cortex-e852fafe-auto-update-openapi-6a9e3873a7492d091ac8c1f.mintlify.site/api-reference/v2/endpoint/tenants-overview.md): Quick reference for all databases endpoints, their lifecycle, and when to call each. - [Create Database](https://cortex-e852fafe-auto-update-openapi-6a9e3873a7492d091ac8c1f.mintlify.site/api-reference/v2/endpoint/create-tenant.md): Creates a space for storing context. - [Update Metadata Schema](https://cortex-e852fafe-auto-update-openapi-6a9e3873a7492d091ac8c1f.mintlify.site/api-reference/v2/endpoint/update-metadata-schema.md): Add new database metadata schema fields after database creation. - [List Databases](https://cortex-e852fafe-auto-update-openapi-6a9e3873a7492d091ac8c1f.mintlify.site/api-reference/v2/endpoint/list-tenants.md): List all databases created. - [Delete Database](https://cortex-e852fafe-auto-update-openapi-6a9e3873a7492d091ac8c1f.mintlify.site/api-reference/v2/endpoint/delete-tenant.md): Permanently remove a database and all of its data. - [Database Status](https://cortex-e852fafe-auto-update-openapi-6a9e3873a7492d091ac8c1f.mintlify.site/api-reference/v2/endpoint/tenant-status.md): Check the readiness of a database's infrastructure. - [List Collections](https://cortex-e852fafe-auto-update-openapi-6a9e3873a7492d091ac8c1f.mintlify.site/api-reference/v2/endpoint/list-sub-tenants.md): List collection IDs inside a database. - [Delete Collection](https://cortex-e852fafe-auto-update-openapi-6a9e3873a7492d091ac8c1f.mintlify.site/api-reference/v2/endpoint/delete-collection.md): Permanently remove one collection and all of its data from a database. - [Database Stats](https://cortex-e852fafe-auto-update-openapi-6a9e3873a7492d091ac8c1f.mintlify.site/api-reference/v2/endpoint/tenant-stats.md): Retrieve usage statistics for a database. - [Context Management - Overview](https://cortex-e852fafe-auto-update-openapi-6a9e3873a7492d091ac8c1f.mintlify.site/api-reference/v2/endpoint/sources-overview.md): Quick reference for context management endpoints, their lifecycle, and when to use which. - [Ingest Context](https://cortex-e852fafe-auto-update-openapi-6a9e3873a7492d091ac8c1f.mintlify.site/api-reference/v2/endpoint/ingest-context.md): Ingestion endpoint for knowledge (documents, app sources) and user memories. - [Ingestion Status](https://cortex-e852fafe-auto-update-openapi-6a9e3873a7492d091ac8c1f.mintlify.site/api-reference/v2/endpoint/source-status.md): Check the processing status of ingested documents. - [Inspect Context](https://cortex-e852fafe-auto-update-openapi-6a9e3873a7492d091ac8c1f.mintlify.site/api-reference/v2/endpoint/fetch-content.md): Inspect the content of a knowledge or memory source. - [List Context](https://cortex-e852fafe-auto-update-openapi-6a9e3873a7492d091ac8c1f.mintlify.site/api-reference/v2/endpoint/list-documents.md): Browse over knowledge or memories with optional filters. Results are paginated. - [Update Source Metadata](https://cortex-e852fafe-auto-update-openapi-6a9e3873a7492d091ac8c1f.mintlify.site/api-reference/v2/endpoint/update-source-metadata.md): Merge tenant metadata and additional metadata for one existing source without re-ingesting its content. - [Delete Context](https://cortex-e852fafe-auto-update-openapi-6a9e3873a7492d091ac8c1f.mintlify.site/api-reference/v2/endpoint/delete-source.md): Delete knowledge or memories by their IDs. - [Inspecting Context Relations](https://cortex-e852fafe-auto-update-openapi-6a9e3873a7492d091ac8c1f.mintlify.site/api-reference/v2/endpoint/source-relations.md): See and explore relationships that create the brain for your AI. - [Connected Subgraph](https://cortex-e852fafe-auto-update-openapi-6a9e3873a7492d091ac8c1f.mintlify.site/api-reference/v2/endpoint/subgraph.md): Everything connected to one item: its thread, its replies, its parents and children, and the items it links to. - [Query - Overview](https://cortex-e852fafe-auto-update-openapi-6a9e3873a7492d091ac8c1f.mintlify.site/api-reference/v2/endpoint/query-overview.md): Quick reference for query modes, type selection, and when to call each. - [Query](https://cortex-e852fafe-auto-update-openapi-6a9e3873a7492d091ac8c1f.mintlify.site/api-reference/v2/endpoint/query.md): Unified retrieval over knowledge, memories, or both. - [Submit Feedback](https://cortex-e852fafe-auto-update-openapi-6a9e3873a7492d091ac8c1f.mintlify.site/api-reference/v2/endpoint/submit-feedback.md): Tell HydraDB how a query performed, so retrieval quality improves. - [Connectors - Overview](https://cortex-e852fafe-auto-update-openapi-6a9e3873a7492d091ac8c1f.mintlify.site/api-reference/v2/endpoint/connectors-overview.md): Quick reference for all connector endpoints, their lifecycle, and when to call each. - [Get Connector Provider](https://cortex-e852fafe-auto-update-openapi-6a9e3873a7492d091ac8c1f.mintlify.site/api-reference/v2/endpoint/get-connector-provider.md): Get a connector provider's indexed fields, query filters, and credential requirements. - [List Connector Providers](https://cortex-e852fafe-auto-update-openapi-6a9e3873a7492d091ac8c1f.mintlify.site/api-reference/v2/endpoint/list-connector-providers.md): List every connector provider available to the authenticated organization. - [Create Connector](https://cortex-e852fafe-auto-update-openapi-6a9e3873a7492d091ac8c1f.mintlify.site/api-reference/v2/endpoint/create-connector.md): Create a new connector that continuously syncs data from an external provider. - [Discover Resources](https://cortex-e852fafe-auto-update-openapi-6a9e3873a7492d091ac8c1f.mintlify.site/api-reference/v2/endpoint/discover-connector-resources.md): List all resources available from the provider before activating them. - [Configure Connector](https://cortex-e852fafe-auto-update-openapi-6a9e3873a7492d091ac8c1f.mintlify.site/api-reference/v2/endpoint/configure-connector.md): Activate resources for sync and set sync options. - [Sync Connector](https://cortex-e852fafe-auto-update-openapi-6a9e3873a7492d091ac8c1f.mintlify.site/api-reference/v2/endpoint/sync-connector.md): Trigger an on-demand sync for a connector. - [List Connector Resources](https://cortex-e852fafe-auto-update-openapi-6a9e3873a7492d091ac8c1f.mintlify.site/api-reference/v2/endpoint/connector-resources.md): List configured resources and their sync state. - [Add Connector Resource](https://cortex-e852fafe-auto-update-openapi-6a9e3873a7492d091ac8c1f.mintlify.site/api-reference/v2/endpoint/add-connector-resource.md): Add a single resource to a connector. - [Delete Connector Resource](https://cortex-e852fafe-auto-update-openapi-6a9e3873a7492d091ac8c1f.mintlify.site/api-reference/v2/endpoint/delete-connector-resource.md): Remove a resource from a connector and stop syncing it. - [List Connectors](https://cortex-e852fafe-auto-update-openapi-6a9e3873a7492d091ac8c1f.mintlify.site/api-reference/v2/endpoint/list-connectors.md): List all connectors for the authenticated organization. - [Get Connector](https://cortex-e852fafe-auto-update-openapi-6a9e3873a7492d091ac8c1f.mintlify.site/api-reference/v2/endpoint/get-connector.md): Fetch metadata and status for a single connector. - [Delete Connector](https://cortex-e852fafe-auto-update-openapi-6a9e3873a7492d091ac8c1f.mintlify.site/api-reference/v2/endpoint/delete-connector.md): Permanently remove a connector and stop all associated syncs. - [Register Webhook](https://cortex-e852fafe-auto-update-openapi-6a9e3873a7492d091ac8c1f.mintlify.site/api-reference/v2/endpoint/register-webhook.md): Register or update the indexing webhook for your workspace. - [Get Webhook](https://cortex-e852fafe-auto-update-openapi-6a9e3873a7492d091ac8c1f.mintlify.site/api-reference/v2/endpoint/get-webhook.md): Retrieve the current webhook registration for your workspace. - [Delete Webhook](https://cortex-e852fafe-auto-update-openapi-6a9e3873a7492d091ac8c1f.mintlify.site/api-reference/v2/endpoint/delete-webhook.md): Remove the webhook registration for your workspace. - [Send Test Delivery](https://cortex-e852fafe-auto-update-openapi-6a9e3873a7492d091ac8c1f.mintlify.site/api-reference/v2/endpoint/test-webhook.md): Send a synthetic delivery to your registered webhook endpoint. - [List Deliveries](https://cortex-e852fafe-auto-update-openapi-6a9e3873a7492d091ac8c1f.mintlify.site/api-reference/v2/endpoint/list-webhook-deliveries.md): List webhook delivery attempts for your workspace. - [Get Delivery](https://cortex-e852fafe-auto-update-openapi-6a9e3873a7492d091ac8c1f.mintlify.site/api-reference/v2/endpoint/get-webhook-delivery.md): Retrieve a single webhook delivery attempt by ID. - [Retry Delivery](https://cortex-e852fafe-auto-update-openapi-6a9e3873a7492d091ac8c1f.mintlify.site/api-reference/v2/endpoint/retry-webhook-delivery.md): Queue a failed webhook delivery to be attempted again. - [Error Responses](https://cortex-e852fafe-auto-update-openapi-6a9e3873a7492d091ac8c1f.mintlify.site/api-reference/v2/error-responses.md): Response envelope, HTTP status codes, error codes, and retry patterns. ## OpenAPI Specs - [openapi](https://cortex-e852fafe-auto-update-openapi-6a9e3873a7492d091ac8c1f.mintlify.site/api-reference/openapi.json)