Database Status

response = client.databases.status(database="my_first_database")

if response.data.infra.ready_for_ingestion:
    print("Database is ready.")

const response = await client.databases.status({
  database: "my_first_database",
});

if (response.data?.infra.readyForIngestion) {
  console.log("Database is ready.");
}

curl -X GET 'https://api.hydradb.com/databases/status?database=my_first_database' \
  -H "Authorization: Bearer <your_api_key>" \
  -H "API-Version: 2"

{
  "success": true,
  "data": {
    "database": "my_first_database",
    "org_id": "org_abc123",
    "infra": {
      "scheduler_status": true,
      "graph_status": true,
      "vectorstore_status": {
        "knowledge": true,
        "memories": true
      },
      "ready_for_ingestion": true
    },
    "message": "Deployed infrastructure status"
  },
  "error": null,
  "meta": {
    "request_id": "9d13aef4-02f4-4e73-8c62-4c2601d04f9d",
    "latency_ms": 12.3
  }
}

{
  "success": false,
  "data": null,
  "error": {
    "code": "DATABASE_NOT_FOUND",
    "message": "Database not found"
  },
  "meta": {
    "request_id": "9d13aef4-02f4-4e73-8c62-4c2601d04f9d",
    "latency_ms": 4.8
  }
}

GET

databases

status

response = client.databases.status(database="my_first_database")

if response.data.infra.ready_for_ingestion:
    print("Database is ready.")

const response = await client.databases.status({
  database: "my_first_database",
});

if (response.data?.infra.readyForIngestion) {
  console.log("Database is ready.");
}

curl -X GET 'https://api.hydradb.com/databases/status?database=my_first_database' \
  -H "Authorization: Bearer <your_api_key>" \
  -H "API-Version: 2"

{
  "success": true,
  "data": {
    "database": "my_first_database",
    "org_id": "org_abc123",
    "infra": {
      "scheduler_status": true,
      "graph_status": true,
      "vectorstore_status": {
        "knowledge": true,
        "memories": true
      },
      "ready_for_ingestion": true
    },
    "message": "Deployed infrastructure status"
  },
  "error": null,
  "meta": {
    "request_id": "9d13aef4-02f4-4e73-8c62-4c2601d04f9d",
    "latency_ms": 12.3
  }
}

{
  "success": false,
  "data": null,
  "error": {
    "code": "DATABASE_NOT_FOUND",
    "message": "Database not found"
  },
  "meta": {
    "request_id": "9d13aef4-02f4-4e73-8c62-4c2601d04f9d",
    "latency_ms": 4.8
  }
}

Database creation is asynchronous, check if your database is ready before executing ingestion or any queries. The response includes infra.ready_for_ingestion, a convenience flag derived from the vectorstore fields below. For a single check, read that field. The underlying signals are:

infra.ready_for_ingestion === true (derived - true once both vectorstores are provisioned)
infra.scheduler_status === true (the background indexing scheduler)
infra.graph_status === true (the graph layer)
infra.vectorstore_status.knowledge === true
infra.vectorstore_status.memories === true

response = client.databases.status(database="my_first_database")

if response.data.infra.ready_for_ingestion:
    print("Database is ready.")

const response = await client.databases.status({
  database: "my_first_database",
});

if (response.data?.infra.readyForIngestion) {
  console.log("Database is ready.");
}

curl -X GET 'https://api.hydradb.com/databases/status?database=my_first_database' \
  -H "Authorization: Bearer <your_api_key>" \
  -H "API-Version: 2"

{
  "success": true,
  "data": {
    "database": "my_first_database",
    "org_id": "org_abc123",
    "infra": {
      "scheduler_status": true,
      "graph_status": true,
      "vectorstore_status": {
        "knowledge": true,
        "memories": true
      },
      "ready_for_ingestion": true
    },
    "message": "Deployed infrastructure status"
  },
  "error": null,
  "meta": {
    "request_id": "9d13aef4-02f4-4e73-8c62-4c2601d04f9d",
    "latency_ms": 12.3
  }
}

{
  "success": false,
  "data": null,
  "error": {
    "code": "DATABASE_NOT_FOUND",
    "message": "Database not found"
  },
  "meta": {
    "request_id": "9d13aef4-02f4-4e73-8c62-4c2601d04f9d",
    "latency_ms": 4.8
  }
}

Stale database IDs: If database does not exist, the call returns 404 DATABASE_NOT_FOUND. Always verify that the database was created successfully before polling.

Common mistake: row_count from Database Stats counts individual chunks, not documents. For distinct source or memory counts, use List Documents and read pagination.total from the response.

Related Resources

Before this: Create Database - kicks off provisioning
After this: Ingest Context - once status is ready

Authorizations

Authorization

string

header

required

API key sent as a Bearer token: "Bearer prefix.secret"

Query Parameters

database

string

required

Database identifier

Example:

"acme_corp"

Response

data

object

Show child attributes

Example:

{
  "database": "acme_corp",
  "infra": {
    "graph_status": true,
    "scheduler_status": true,
    "vectorstore_status": { "knowledge": true, "memories": true }
  },
  "message": "Success",
  "org_id": "org_1a2b3c",
  "tenant_id": "tenant_1234"
}

error

object

Error message, empty string on success.

Show child attributes

Example:

{
  "code": "DATABASE_NOT_FOUND",
  "message": "Database not found"
}

API Documentation

Databases

Context

Query

Connectors

Miscellaneous

Authorizations

Query Parameters

Response