v1

latestOpenAPI 3.1.0Proprietary2026-07-262570100.1 KB
database-management

List databases

List all databases for the authenticated user

get/databases

Response

OK

successboolean

Whether the request succeeded.

Example response

{
  "data": {
    "databases": [
      "acme_corp",
      "research_kb"
    ],
    "failed_databases": [
      {
        "database": "acme_corp",
        "error": "",
        "tenant_id": "tenant_1234"
      }
    ],
    "failed_tenant_ids": [
      {
        "database": "acme_corp",
        "error": "",
        "tenant_id": "tenant_1234"
      }
    ],
    "message": "Success",
    "tenant_ids": [
      "tenant_1234",
      "tenant_5678"
    ]
  },
  "error": {
    "code": "DATABASE_NOT_FOUND",
    "message": "Database not found"
  },
  "meta": {
    "collection": "team_docs",
    "database": "acme_corp",
    "deprecation": [
      {
        "deprecated": true,
        "deprecated_field": "tenant_id",
        "deprecated_since": "2.0.1",
        "message": "tenant_id is deprecated; use database instead.",
        "preferred_field": "database"
      }
    ],
    "latency_ms": 12.3,
    "request_id": "9d13aef4-02f4-4e73-8c62-4c2601d04f9d",
    "source_type": "file",
    "sub_tenant_id": "sub_tenant_4567",
    "tenant_id": "tenant_1234"
  },
  "success": true
}