API Reference

​

The four calls

1. Create Database: POST /databases. Isolates context for a customer, environment, or product. Creation runs in the background, so poll Database Status until ready_for_ingestion is true.
2. Ingest Context: POST /context/ingest. Files, app sources, or memories, in one multipart request.
3. Ingestion Status: GET /context/status. Poll the returned ids until indexing_status is completed, or register a webhook instead.
4. Query: POST /query. Retrieve the context your model needs, from knowledge, memories, or both.

​

Every endpoint

​

Databases

​

Context

​

Query

​

Connectors

​

Webhooks

​

Conventions

curl -X POST 'https://api.hydradb.com/query' \
  -H "Authorization: Bearer <your_api_key>" \
  -H "API-Version: 2" \
  -H "Content-Type: application/json" \
  -d '{
    "database": "my_first_database",
    "query": "What are the pricing tiers?",
    "type": "knowledge",
    "query_by": "hybrid"
  }'

{
  "success": true,
  "data": {},
  "error": null,
  "meta": {
    "request_id": "request-id",
    "latency_ms": 12.3
  }
}

• Database scoping: Use database to select a database and collection to scope context within it. Omitting collection uses the default collection.
• Async operations: Database creation, database and collection deletion, and content ingestion are asynchronous. They return immediately after queuing. Use the relevant status endpoint to confirm completion before downstream operations.
• Pagination: Listing endpoints (/context/list) return pagination fields for browsing large result sets.
• Parameter casing: The REST API uses snake_case (database, max_results). The TypeScript SDK uses camelCase keys and method names (maxResults, deleteCollection) and ignores request keys it does not recognize, including snake_case ones. The Python SDK uses snake_case throughout. See SDKs.

​

Rate limits

​

Next steps

• Build something: Quickstart walks through your first integration in five minutes
• Understand the model: Core Concepts explains databases, context, and queries
• Query options: Query guide explains retrieval modes and ranking
• Install an SDK: Python · TypeScript