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
}
}
Databases
Database Status
Check the readiness of a database’s infrastructure.
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
Stale database IDs: If
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 === trueinfra.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
}
}
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
API key sent as a Bearer token: "Bearer prefix.secret"
Query Parameters
Database identifier
Example:
"acme_corp"
Response
OK
Show child attributes
Show child attributes
Example:
{
"database": "acme_corp",
"infra": {
"graph_status": true,
"ready_for_ingestion": true,
"scheduler_status": true,
"vectorstore_status": { "knowledge": true, "memories": true }
},
"message": "Success",
"org_id": "org_1a2b3c",
"tenant_id": "tenant_1234"
}
Error message, empty string on success.
Show child attributes
Show child attributes
Example:
{
"code": "DATABASE_NOT_FOUND",
"message": "Database not found"
}
Show child attributes
Show child attributes
Example:
{
"collection": "team_docs",
"database": "acme_corp",
"latency_ms": 12.3,
"request_id": "9d13aef4-02f4-4e73-8c62-4c2601d04f9d",
"source_type": "file",
"sub_tenant_id": "sub_tenant_4567",
"tenant_id": "tenant_1234"
}
Whether the request succeeded.
Example:
true
Was this page helpful?