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 my_first_database does not exist"
},
"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 my_first_database does not exist"
},
"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 four signals below. For a single check, read that field. The underlying signals are:
infra.ready_for_ingestion === true(derived: true only when all four signals below are true)infra.scheduler_status === true(lifecycle provisioning has finished;falsewhile the database is still being created, even if some collections already exist)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 my_first_database does not exist"
},
"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.
Querying too early: a POST /query sent before ready_for_ingestion is true returns 422 TENANT_INFRA_NOT_READY.
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"
}
Null on success; an object with code and message on failure.
Show child attributes
Show child attributes
Example:
null
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": "team_docs",
"tenant_id": "acme_corp"
}
Whether the request succeeded.
Example:
true
Was this page helpful?