# HydraDB SDK ## Docs - [Introduction](https://cortex-e852fafe-docs-pro-2457-api-response-cleanup.mintlify.site/get-started/v2/introduction.md): Welcome to HydraDB. The unified context substrate for AI. - [Core Concepts](https://cortex-e852fafe-docs-pro-2457-api-response-cleanup.mintlify.site/get-started/v2/core-concepts.md): A tour of the five primitives that make HydraDB. - [Quickstart](https://cortex-e852fafe-docs-pro-2457-api-response-cleanup.mintlify.site/get-started/v2/quickstart.md): Build your first working query in five minutes. - [Knowledge](https://cortex-e852fafe-docs-pro-2457-api-response-cleanup.mintlify.site/essentials/v2/knowledge.md): What Knowledge is, how it differs from Memories, and how to ingest it correctly. - [Memories](https://cortex-e852fafe-docs-pro-2457-api-response-cleanup.mintlify.site/essentials/v2/memories.md): How to use Memories to personalize responses with user-specific context. - [App Sources](https://cortex-e852fafe-docs-pro-2457-api-response-cleanup.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-docs-pro-2457-api-response-cleanup.mintlify.site/essentials/v2/connectors.md): How HydraDB connectors continuously sync external app data into your database. - [Custom Ingestion Instructions](https://cortex-e852fafe-docs-pro-2457-api-response-cleanup.mintlify.site/essentials/v2/connector-instructions.md): Steer how a connector's data is interpreted and indexed with free-text instructions, per connector or per resource. - [Query](https://cortex-e852fafe-docs-pro-2457-api-response-cleanup.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-docs-pro-2457-api-response-cleanup.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-docs-pro-2457-api-response-cleanup.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-docs-pro-2457-api-response-cleanup.mintlify.site/essentials/v2/api-results.md): Turn a query response into an LLM prompt. - [Architecture](https://cortex-e852fafe-docs-pro-2457-api-response-cleanup.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-docs-pro-2457-api-response-cleanup.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-docs-pro-2457-api-response-cleanup.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-docs-pro-2457-api-response-cleanup.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-docs-pro-2457-api-response-cleanup.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-docs-pro-2457-api-response-cleanup.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-docs-pro-2457-api-response-cleanup.mintlify.site/essentials/v2/semantic-search.md): How semantic, keyword bm25, graph, and metadata signals work together in HydraDB query. - [Webhooks](https://cortex-e852fafe-docs-pro-2457-api-response-cleanup.mintlify.site/essentials/v2/webhooks.md): Receive indexing status events when ingested content finishes processing. - [Claude Code](https://cortex-e852fafe-docs-pro-2457-api-response-cleanup.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-docs-pro-2457-api-response-cleanup.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-docs-pro-2457-api-response-cleanup.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-docs-pro-2457-api-response-cleanup.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-docs-pro-2457-api-response-cleanup.mintlify.site/AGENTS.md): LLM-facing reference for building against the current HydraDB docs, API, SDKs, and cookbooks. - [Introduction](https://cortex-e852fafe-docs-pro-2457-api-response-cleanup.mintlify.site/cookbooks/v2/index.md): Production-ready guides for building AI agents with HydraDB. - [Build your own Glean with HydraDB](https://cortex-e852fafe-docs-pro-2457-api-response-cleanup.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-docs-pro-2457-api-response-cleanup.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-docs-pro-2457-api-response-cleanup.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-docs-pro-2457-api-response-cleanup.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-docs-pro-2457-api-response-cleanup.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-docs-pro-2457-api-response-cleanup.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-docs-pro-2457-api-response-cleanup.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-docs-pro-2457-api-response-cleanup.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-docs-pro-2457-api-response-cleanup.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-docs-pro-2457-api-response-cleanup.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-docs-pro-2457-api-response-cleanup.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-docs-pro-2457-api-response-cleanup.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-docs-pro-2457-api-response-cleanup.mintlify.site/api-reference/v2/index.md): The four calls most integrations are built on, then every v2 endpoint. - [Create Database](https://cortex-e852fafe-docs-pro-2457-api-response-cleanup.mintlify.site/api-reference/v2/endpoint/create-tenant.md): Create an isolated database, with an optional metadata schema. - [Ingest Context](https://cortex-e852fafe-docs-pro-2457-api-response-cleanup.mintlify.site/api-reference/v2/endpoint/ingest-context.md): Ingestion endpoint for knowledge (documents, app sources) and user memories. - [Ingestion Status](https://cortex-e852fafe-docs-pro-2457-api-response-cleanup.mintlify.site/api-reference/v2/endpoint/source-status.md): Check whether ingested documents, app sources, or memories are ready to query. - [Query](https://cortex-e852fafe-docs-pro-2457-api-response-cleanup.mintlify.site/api-reference/v2/endpoint/query.md): Unified retrieval over knowledge, memories, or both. - [Databases: Overview](https://cortex-e852fafe-docs-pro-2457-api-response-cleanup.mintlify.site/api-reference/v2/endpoint/tenants-overview.md): Every database endpoint, the order to call them in, and what each is for. - [Database Status](https://cortex-e852fafe-docs-pro-2457-api-response-cleanup.mintlify.site/api-reference/v2/endpoint/tenant-status.md): Check the readiness of a database's infrastructure. - [List Databases](https://cortex-e852fafe-docs-pro-2457-api-response-cleanup.mintlify.site/api-reference/v2/endpoint/list-tenants.md): List the databases your API key can see, including any that failed to provision. - [Database Stats](https://cortex-e852fafe-docs-pro-2457-api-response-cleanup.mintlify.site/api-reference/v2/endpoint/tenant-stats.md): Retrieve usage statistics for a database. - [Update Metadata Schema](https://cortex-e852fafe-docs-pro-2457-api-response-cleanup.mintlify.site/api-reference/v2/endpoint/update-metadata-schema.md): Add new database metadata schema fields after database creation. - [List Collections](https://cortex-e852fafe-docs-pro-2457-api-response-cleanup.mintlify.site/api-reference/v2/endpoint/list-sub-tenants.md): List collection IDs inside a database. - [Delete Collection](https://cortex-e852fafe-docs-pro-2457-api-response-cleanup.mintlify.site/api-reference/v2/endpoint/delete-collection.md): Permanently remove one collection and all of its data from a database. - [Delete Database](https://cortex-e852fafe-docs-pro-2457-api-response-cleanup.mintlify.site/api-reference/v2/endpoint/delete-tenant.md): Permanently remove a database and all of its data. - [Context Management: Overview](https://cortex-e852fafe-docs-pro-2457-api-response-cleanup.mintlify.site/api-reference/v2/endpoint/sources-overview.md): Every context endpoint, the ingestion lifecycle, and which call to use for which content. - [List Context](https://cortex-e852fafe-docs-pro-2457-api-response-cleanup.mintlify.site/api-reference/v2/endpoint/list-documents.md): Page through knowledge sources or memories, with optional filters. - [Inspect Context](https://cortex-e852fafe-docs-pro-2457-api-response-cleanup.mintlify.site/api-reference/v2/endpoint/fetch-content.md): Read the original content of a knowledge source or memory, or get a download URL. - [Update Source Metadata](https://cortex-e852fafe-docs-pro-2457-api-response-cleanup.mintlify.site/api-reference/v2/endpoint/update-source-metadata.md): Merge database metadata and additional metadata into one existing source, without re-ingesting it. - [Inspecting Context Relations](https://cortex-e852fafe-docs-pro-2457-api-response-cleanup.mintlify.site/api-reference/v2/endpoint/source-relations.md): Read the entity-relation triplets extracted from your content, for one source or a whole collection. - [Connected Subgraph](https://cortex-e852fafe-docs-pro-2457-api-response-cleanup.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. - [Delete Context](https://cortex-e852fafe-docs-pro-2457-api-response-cleanup.mintlify.site/api-reference/v2/endpoint/delete-source.md): Delete knowledge or memories by their IDs. - [Query: Overview](https://cortex-e852fafe-docs-pro-2457-api-response-cleanup.mintlify.site/api-reference/v2/endpoint/query-overview.md): Choose type, query_by, and mode for a query, with recipes for common cases. - [Submit Feedback](https://cortex-e852fafe-docs-pro-2457-api-response-cleanup.mintlify.site/api-reference/v2/endpoint/submit-feedback.md): Tell HydraDB how a query performed, so retrieval quality improves. - [Connectors: Overview](https://cortex-e852fafe-docs-pro-2457-api-response-cleanup.mintlify.site/api-reference/v2/endpoint/connectors-overview.md): Every connector endpoint, the order to call them in, and which one to use to change what. - [List Connector Providers](https://cortex-e852fafe-docs-pro-2457-api-response-cleanup.mintlify.site/api-reference/v2/endpoint/list-connector-providers.md): List the providers you can connect, or describe one: its credentials and the fields you can filter on. - [Create Connector](https://cortex-e852fafe-docs-pro-2457-api-response-cleanup.mintlify.site/api-reference/v2/endpoint/create-connector.md): Store credentials for one provider account so its data can be synced. - [Discover Resources](https://cortex-e852fafe-docs-pro-2457-api-response-cleanup.mintlify.site/api-reference/v2/endpoint/discover-connector-resources.md): List the resources a connector's credentials can reach, before choosing which to sync. - [Configure Connector](https://cortex-e852fafe-docs-pro-2457-api-response-cleanup.mintlify.site/api-reference/v2/endpoint/configure-connector.md): Choose which resources a connector syncs, and start the first sync. - [Get Connector Status](https://cortex-e852fafe-docs-pro-2457-api-response-cleanup.mintlify.site/api-reference/v2/endpoint/get-connector-status.md): Check whether a connector is working, with per-resource health, in one call. - [List Connectors](https://cortex-e852fafe-docs-pro-2457-api-response-cleanup.mintlify.site/api-reference/v2/endpoint/list-connectors.md): List every connector in your workspace. - [Update Connector](https://cortex-e852fafe-docs-pro-2457-api-response-cleanup.mintlify.site/api-reference/v2/endpoint/update-connector.md): Change a connector's instructions, sync interval or credentials in place. - [Update Connector Resource](https://cortex-e852fafe-docs-pro-2457-api-response-cleanup.mintlify.site/api-reference/v2/endpoint/update-connector-resource.md): Change one resource's ingestion instructions or access rule, leaving everything else as it is. - [Register Webhook](https://cortex-e852fafe-docs-pro-2457-api-response-cleanup.mintlify.site/api-reference/v2/endpoint/register-webhook.md): Register or update the indexing webhook for your workspace. - [Get Webhook](https://cortex-e852fafe-docs-pro-2457-api-response-cleanup.mintlify.site/api-reference/v2/endpoint/get-webhook.md): Retrieve the current webhook registration for your workspace. - [Delete Webhook](https://cortex-e852fafe-docs-pro-2457-api-response-cleanup.mintlify.site/api-reference/v2/endpoint/delete-webhook.md): Remove the webhook registration for your workspace. - [Send Test Delivery](https://cortex-e852fafe-docs-pro-2457-api-response-cleanup.mintlify.site/api-reference/v2/endpoint/test-webhook.md): Send a synthetic delivery to your registered webhook endpoint. - [List Deliveries](https://cortex-e852fafe-docs-pro-2457-api-response-cleanup.mintlify.site/api-reference/v2/endpoint/list-webhook-deliveries.md): List webhook delivery attempts for your workspace. - [Get Delivery](https://cortex-e852fafe-docs-pro-2457-api-response-cleanup.mintlify.site/api-reference/v2/endpoint/get-webhook-delivery.md): Retrieve a single webhook delivery attempt by ID. - [Retry Delivery](https://cortex-e852fafe-docs-pro-2457-api-response-cleanup.mintlify.site/api-reference/v2/endpoint/retry-webhook-delivery.md): Queue a failed webhook delivery to be attempted again. - [SDKs: Python and TypeScript](https://cortex-e852fafe-docs-pro-2457-api-response-cleanup.mintlify.site/api-reference/v2/sdks.md): Official Python and TypeScript/Node.js SDKs for the HydraDB API. - [Error Responses](https://cortex-e852fafe-docs-pro-2457-api-response-cleanup.mintlify.site/api-reference/v2/error-responses.md): Response envelope, HTTP status codes, error codes, and retry patterns. ## OpenAPI Specs - [openapi](https://cortex-e852fafe-docs-pro-2457-api-response-cleanup.mintlify.site/api-reference/openapi.json) This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.