# HydraDB SDK

## Docs

- [Introduction](https://cortex-e852fafe-t3code-rewrite-docs-declutter.mintlify.site/get-started/v2/introduction.md): Store documents and user memories, find relevant information, and use it in your AI application.
- [Core Concepts](https://cortex-e852fafe-t3code-rewrite-docs-declutter.mintlify.site/get-started/v2/core-concepts.md): Understand what to store, where to store it, and what a query returns.
- [Quickstart](https://cortex-e852fafe-t3code-rewrite-docs-declutter.mintlify.site/get-started/v2/quickstart.md): Save a user preference, retrieve it, and prepare it for your AI model.
- [Knowledge](https://cortex-e852fafe-t3code-rewrite-docs-declutter.mintlify.site/essentials/v2/knowledge.md): What Knowledge is, how it differs from Memories, and how to ingest it correctly.
- [Memories](https://cortex-e852fafe-t3code-rewrite-docs-declutter.mintlify.site/essentials/v2/memories.md): How to use Memories to personalize responses with user-specific context.
- [App Sources](https://cortex-e852fafe-t3code-rewrite-docs-declutter.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-t3code-rewrite-docs-declutter.mintlify.site/essentials/v2/connectors.md): How HydraDB connectors continuously sync external app data into your database.
- [Custom Ingestion Instructions](https://cortex-e852fafe-t3code-rewrite-docs-declutter.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-t3code-rewrite-docs-declutter.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.
- [Metadata and Filters](https://cortex-e852fafe-t3code-rewrite-docs-declutter.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-t3code-rewrite-docs-declutter.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-t3code-rewrite-docs-declutter.mintlify.site/essentials/v2/api-results.md): Turn a query response into an LLM prompt.
- [Architecture](https://cortex-e852fafe-t3code-rewrite-docs-declutter.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.
- [Databases and Collections](https://cortex-e852fafe-t3code-rewrite-docs-declutter.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-t3code-rewrite-docs-declutter.mintlify.site/essentials/v2/glossary.md): The terms HydraDB uses across the docs, and the deprecated aliases you may still see.
- [Context Graphs](https://cortex-e852fafe-t3code-rewrite-docs-declutter.mintlify.site/essentials/v2/context-graphs.md): How HydraDB models relationships between chunks using triplets to improve query quality.
- [Bring Your Own Graph: per source](https://cortex-e852fafe-t3code-rewrite-docs-declutter.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: Cypher collections](https://cortex-e852fafe-t3code-rewrite-docs-declutter.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-t3code-rewrite-docs-declutter.mintlify.site/essentials/v2/semantic-search.md): How semantic, BM25 keyword, graph, and metadata signals work together in a HydraDB query.
- [Webhooks](https://cortex-e852fafe-t3code-rewrite-docs-declutter.mintlify.site/essentials/v2/webhooks.md): Receive indexing status events when ingested content finishes processing.
- [Claude Code](https://cortex-e852fafe-t3code-rewrite-docs-declutter.mintlify.site/plugins/claude-code.md): HydraDB plugin for Claude Code: persistent memory across sessions and projects.
- [HydraDB MCP](https://cortex-e852fafe-t3code-rewrite-docs-declutter.mintlify.site/plugins/mcp.md): MCP (Model Context Protocol) server for HydraDB. Provides tools for storing, recalling, and managing memories with knowledge-graph enriched context.
- [HydraDB CLI](https://cortex-e852fafe-t3code-rewrite-docs-declutter.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-t3code-rewrite-docs-declutter.mintlify.site/plugins/openclaw.md): HydraDB plugin for OpenClaw. Automatically captures conversations, recalls relevant context with knowledge-graph connections, and injects it before every AI turn.
- [HydraDB Agent Integration Guide](https://cortex-e852fafe-t3code-rewrite-docs-declutter.mintlify.site/AGENTS.md): LLM-facing reference for building against the current HydraDB docs, API, SDKs, and cookbooks.
- [Introduction](https://cortex-e852fafe-t3code-rewrite-docs-declutter.mintlify.site/cookbooks/v2/index.md): Production-ready guides for building AI agents with HydraDB.
- [Build your own Glean with HydraDB](https://cortex-e852fafe-t3code-rewrite-docs-declutter.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-t3code-rewrite-docs-declutter.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-t3code-rewrite-docs-declutter.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-t3code-rewrite-docs-declutter.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-t3code-rewrite-docs-declutter.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-t3code-rewrite-docs-declutter.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-t3code-rewrite-docs-declutter.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-t3code-rewrite-docs-declutter.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-t3code-rewrite-docs-declutter.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-t3code-rewrite-docs-declutter.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-t3code-rewrite-docs-declutter.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-t3code-rewrite-docs-declutter.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-t3code-rewrite-docs-declutter.mintlify.site/api-reference/v2/index.md): Single reference to all HydraDB endpoints
- [SDKs – Python and Node](https://cortex-e852fafe-t3code-rewrite-docs-declutter.mintlify.site/api-reference/v2/sdks.md): Official Python and TypeScript/Node.js SDKs for the HydraDB API.
- [Databases - Overview](https://cortex-e852fafe-t3code-rewrite-docs-declutter.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-t3code-rewrite-docs-declutter.mintlify.site/api-reference/v2/endpoint/create-tenant.md): Creates a space for storing context.
- [Update Metadata Schema](https://cortex-e852fafe-t3code-rewrite-docs-declutter.mintlify.site/api-reference/v2/endpoint/update-metadata-schema.md): Add new database metadata schema fields after database creation.
- [List Databases](https://cortex-e852fafe-t3code-rewrite-docs-declutter.mintlify.site/api-reference/v2/endpoint/list-tenants.md): List all databases created.
- [Delete Database](https://cortex-e852fafe-t3code-rewrite-docs-declutter.mintlify.site/api-reference/v2/endpoint/delete-tenant.md): Permanently remove a database and all of its data.
- [Database Status](https://cortex-e852fafe-t3code-rewrite-docs-declutter.mintlify.site/api-reference/v2/endpoint/tenant-status.md): Check the readiness of a database's infrastructure.
- [List Collections](https://cortex-e852fafe-t3code-rewrite-docs-declutter.mintlify.site/api-reference/v2/endpoint/list-sub-tenants.md): List collection IDs inside a database.
- [Delete Collection](https://cortex-e852fafe-t3code-rewrite-docs-declutter.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-t3code-rewrite-docs-declutter.mintlify.site/api-reference/v2/endpoint/tenant-stats.md): Retrieve usage statistics for a database.
- [Context Management - Overview](https://cortex-e852fafe-t3code-rewrite-docs-declutter.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-t3code-rewrite-docs-declutter.mintlify.site/api-reference/v2/endpoint/ingest-context.md): Ingestion endpoint for knowledge (documents, app sources) and user memories.
- [Ingestion Status](https://cortex-e852fafe-t3code-rewrite-docs-declutter.mintlify.site/api-reference/v2/endpoint/source-status.md): Check the processing status of ingested documents.
- [Inspect Context](https://cortex-e852fafe-t3code-rewrite-docs-declutter.mintlify.site/api-reference/v2/endpoint/fetch-content.md): Inspect the content of a knowledge or memory source.
- [List Context](https://cortex-e852fafe-t3code-rewrite-docs-declutter.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-t3code-rewrite-docs-declutter.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-t3code-rewrite-docs-declutter.mintlify.site/api-reference/v2/endpoint/delete-source.md): Delete knowledge or memories by their IDs.
- [Inspecting Context Relations](https://cortex-e852fafe-t3code-rewrite-docs-declutter.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-t3code-rewrite-docs-declutter.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-t3code-rewrite-docs-declutter.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-t3code-rewrite-docs-declutter.mintlify.site/api-reference/v2/endpoint/query.md): Unified retrieval over knowledge, memories, or both.
- [Submit Feedback](https://cortex-e852fafe-t3code-rewrite-docs-declutter.mintlify.site/api-reference/v2/endpoint/submit-feedback.md): Tell HydraDB how a query performed, so retrieval quality improves.
- [Connectors - Overview](https://cortex-e852fafe-t3code-rewrite-docs-declutter.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-t3code-rewrite-docs-declutter.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-t3code-rewrite-docs-declutter.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-t3code-rewrite-docs-declutter.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-t3code-rewrite-docs-declutter.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-t3code-rewrite-docs-declutter.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-t3code-rewrite-docs-declutter.mintlify.site/api-reference/v2/endpoint/list-connectors.md): List every connector in your workspace.
- [Update Connector](https://cortex-e852fafe-t3code-rewrite-docs-declutter.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-t3code-rewrite-docs-declutter.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-t3code-rewrite-docs-declutter.mintlify.site/api-reference/v2/endpoint/register-webhook.md): Register or update the indexing webhook for your workspace.
- [Get Webhook](https://cortex-e852fafe-t3code-rewrite-docs-declutter.mintlify.site/api-reference/v2/endpoint/get-webhook.md): Retrieve the current webhook registration for your workspace.
- [Delete Webhook](https://cortex-e852fafe-t3code-rewrite-docs-declutter.mintlify.site/api-reference/v2/endpoint/delete-webhook.md): Remove the webhook registration for your workspace.
- [Send Test Delivery](https://cortex-e852fafe-t3code-rewrite-docs-declutter.mintlify.site/api-reference/v2/endpoint/test-webhook.md): Send a synthetic delivery to your registered webhook endpoint.
- [List Deliveries](https://cortex-e852fafe-t3code-rewrite-docs-declutter.mintlify.site/api-reference/v2/endpoint/list-webhook-deliveries.md): List webhook delivery attempts for your workspace.
- [Get Delivery](https://cortex-e852fafe-t3code-rewrite-docs-declutter.mintlify.site/api-reference/v2/endpoint/get-webhook-delivery.md): Retrieve a single webhook delivery attempt by ID.
- [Retry Delivery](https://cortex-e852fafe-t3code-rewrite-docs-declutter.mintlify.site/api-reference/v2/endpoint/retry-webhook-delivery.md): Queue a failed webhook delivery to be attempted again.
- [Error Responses](https://cortex-e852fafe-t3code-rewrite-docs-declutter.mintlify.site/api-reference/v2/error-responses.md): Response envelope, HTTP status codes, error codes, and retry patterns.

## OpenAPI Specs

- [openapi](https://cortex-e852fafe-t3code-rewrite-docs-declutter.mintlify.site/api-reference/openapi.json)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.