diff --git a/404.html b/404.html index 1d51fae..da60b9c 100644 --- a/404.html +++ b/404.html @@ -262,6 +262,26 @@ + + +
  • + + + + + + Tools + + +
    • + + + + + + + +
  • @@ -1289,6 +1309,242 @@ + + + + + + + + + + + + + + + + + + + + + +
  • + + + + + + + +
    + + + + + Tools + + + + + + + + +
    + + + +
    • + + + + + + +
  • diff --git a/changelog.html b/changelog.html index 620e069..5141801 100644 --- a/changelog.html +++ b/changelog.html @@ -13,7 +13,7 @@ - + @@ -270,6 +270,26 @@ + + + +
  • + + + + + + Tools + + +
    • + + + + + + + @@ -1300,6 +1320,242 @@ + + + + + + + + + + + + + + + + + + + + + +
  • + + + + + + + +
    + + + + + Tools + + + + + + + + +
    + + + +
    • + + + + + + + @@ -1771,7 +2027,7 @@

    deeporigin v2.1.0 - +
    @@ -1781,7 +2037,7 @@

    deeporigin v2.1.0
    - Get info about your workstation + Autodock Vina

    diff --git a/compute-hub/index.html b/compute-hub/index.html index cb12a19..e4268e0 100644 --- a/compute-hub/index.html +++ b/compute-hub/index.html @@ -275,6 +275,26 @@ + + +
  • + + + + + + Tools + + +
    • + + + + + + + +
  • @@ -1310,6 +1330,242 @@ + + + + + + + + + + + + + + + + + + + + + +
  • + + + + + + + +
    + + + + + Tools + + + + + + + + +
    + + + +
    • + + + + + + +
  • diff --git a/configure.html b/configure.html index 76e817d..b0c62ec 100644 --- a/configure.html +++ b/configure.html @@ -275,6 +275,26 @@ + + +
  • + + + + + + Tools + + +
    • + + + + + + + +
  • @@ -1385,6 +1405,242 @@ + + + + + + + + + + + + + + + + + + + + + +
  • + + + + + + + +
    + + + + + Tools + + + + + + + + +
    + + + +
    • + + + + + + +
  • diff --git a/data-hub/dataframes.html b/data-hub/dataframes.html index ea8112b..4a59284 100644 --- a/data-hub/dataframes.html +++ b/data-hub/dataframes.html @@ -275,6 +275,26 @@ + + +
  • + + + + + + Tools + + +
    • + + + + + + + +
  • @@ -1420,6 +1440,242 @@ + + + + + + + + + + + + + + + + + + + + + +
  • + + + + + + + +
    + + + + + Tools + + + + + + + + +
    + + + +
    • + + + + + + +
  • @@ -1593,6 +1849,21 @@

    Create a DataFrame +

    Fetching only some rows

    +

    If you have a particularly large database, you may want to fetch only certain rows using a filter. For example, to fetch only rows where column x is greater than 42:

    +

    ```python +from deeporigin.data_hub import filters +filter = filters.filter( + column_id="x", # can be name or column + filter_value=42, + operator="greaterThan", + filter_type="number", +) +df = DataFrame.from_deeporigin("your-db-id", filter=filter) +df

    + +

    ```

    Modify data in the DataFrame

    Because a Deep Origin DataFrame is a subclass of a pandas DataFrame, all pandas DataFrame methods work on Deep Origin DataFrames. In this example, we modify values in one of the columns, or modify a single cell.

    diff --git a/data-hub/index.html b/data-hub/index.html index c44534e..c5a345f 100644 --- a/data-hub/index.html +++ b/data-hub/index.html @@ -275,6 +275,26 @@ + + +
  • + + + + + + Tools + + +
    • + + + + + + + +
  • @@ -1316,6 +1336,242 @@ + + + + + + + + + + + + + + + + + + + + + +
  • + + + + + + + +
    + + + + + Tools + + + + + + + + +
    + + + +
    • + + + + + + +
  • diff --git a/how-to/auth.html b/how-to/auth.html index b407086..e95a039 100644 --- a/how-to/auth.html +++ b/how-to/auth.html @@ -275,6 +275,26 @@ + + +
  • + + + + + + Tools + + +
    • + + + + + + + +
  • @@ -1317,6 +1337,242 @@ + + + + + + + + + + + + + + + + + + + + + +
  • + + + + + + + +
    + + + + + Tools + + + + + + + + +
    + + + +
    • + + + + + + +
  • diff --git a/how-to/compute-hub/variables.html b/how-to/compute-hub/variables.html index 1b7d3f7..6a2132e 100644 --- a/how-to/compute-hub/variables.html +++ b/how-to/compute-hub/variables.html @@ -275,6 +275,26 @@ + + +
  • + + + + + + Tools + + +
    • + + + + + + + +
  • @@ -1322,6 +1342,242 @@ + + + + + + + + + + + + + + + + + + + + + +
  • + + + + + + + +
    + + + + + Tools + + + + + + + + +
    + + + +
    • + + + + + + +
  • diff --git a/how-to/compute-hub/workstation-info.html b/how-to/compute-hub/workstation-info.html index c03f0a9..057e840 100644 --- a/how-to/compute-hub/workstation-info.html +++ b/how-to/compute-hub/workstation-info.html @@ -16,7 +16,7 @@ - + @@ -275,6 +275,26 @@ + + +
  • + + + + + + Tools + + +
    • + + + + + + + +
  • @@ -1322,6 +1342,242 @@ + + + + + + + + + + + + + + + + + + + + + +
  • + + + + + + + +
    + + + + + Tools + + + + + + + + +
    + + + +
    • + + + + + + +
  • @@ -1471,13 +1727,13 @@

    Get information abou - +
    Next
    - Changelog + Tools on Deep Origin
    diff --git a/how-to/data-hub/add-data.html b/how-to/data-hub/add-data.html index 371e834..1dbfd2e 100644 --- a/how-to/data-hub/add-data.html +++ b/how-to/data-hub/add-data.html @@ -275,6 +275,26 @@ + + +
  • + + + + + + Tools + + +
    • + + + + + + + +
  • @@ -1387,6 +1407,242 @@ + + + + + + + + + + + + + + + + + + + + + +
  • + + + + + + + +
    + + + + + Tools + + + + + + + + +
    + + + +
    • + + + + + + +
  • diff --git a/how-to/data-hub/create.html b/how-to/data-hub/create.html index 6fa492e..3b10777 100644 --- a/how-to/data-hub/create.html +++ b/how-to/data-hub/create.html @@ -275,6 +275,26 @@ + + +
  • + + + + + + Tools + + +
    • + + + + + + + +
  • @@ -1383,6 +1403,242 @@ + + + + + + + + + + + + + + + + + + + + + +
  • + + + + + + + +
    + + + + + Tools + + + + + + + + +
    + + + +
    • + + + + + + +
  • diff --git a/how-to/data-hub/delete.html b/how-to/data-hub/delete.html index 0a02f6b..41930fb 100644 --- a/how-to/data-hub/delete.html +++ b/how-to/data-hub/delete.html @@ -275,6 +275,26 @@ + + +
  • + + + + + + Tools + + +
    • + + + + + + + +
  • @@ -1392,6 +1412,242 @@ + + + + + + + + + + + + + + + + + + + + + +
  • + + + + + + + +
    + + + + + Tools + + + + + + + + +
    + + + +
    • + + + + + + +
  • diff --git a/how-to/data-hub/download-files.html b/how-to/data-hub/download-files.html index 96c399c..7e45444 100644 --- a/how-to/data-hub/download-files.html +++ b/how-to/data-hub/download-files.html @@ -275,6 +275,26 @@ + + +
  • + + + + + + Tools + + +
    • + + + + + + + +
  • @@ -1369,6 +1389,242 @@ + + + + + + + + + + + + + + + + + + + + + +
  • + + + + + + + +
    + + + + + Tools + + + + + + + + +
    + + + +
    • + + + + + + +
  • diff --git a/how-to/data-hub/list-data.html b/how-to/data-hub/list-data.html index da2cdd4..1e46058 100644 --- a/how-to/data-hub/list-data.html +++ b/how-to/data-hub/list-data.html @@ -275,6 +275,26 @@ + + +
  • + + + + + + Tools + + +
    • + + + + + + + +
  • @@ -1392,6 +1412,242 @@ + + + + + + + + + + + + + + + + + + + + + +
  • + + + + + + + +
    + + + + + Tools + + + + + + + + +
    + + + +
    • + + + + + + +
  • diff --git a/how-to/data-hub/upload-files.html b/how-to/data-hub/upload-files.html index b889083..36386f9 100644 --- a/how-to/data-hub/upload-files.html +++ b/how-to/data-hub/upload-files.html @@ -275,6 +275,26 @@ + + +
  • + + + + + + Tools + + +
    • + + + + + + + +
  • @@ -1387,6 +1407,242 @@ + + + + + + + + + + + + + + + + + + + + + +
  • + + + + + + + +
    + + + + + Tools + + + + + + + + +
    + + + +
    • + + + + + + +
  • diff --git a/how-to/data-hub/view-data.html b/how-to/data-hub/view-data.html index fdb0397..cf60d06 100644 --- a/how-to/data-hub/view-data.html +++ b/how-to/data-hub/view-data.html @@ -275,6 +275,26 @@ + + +
  • + + + + + + Tools + + +
    • + + + + + + + +
  • @@ -1426,6 +1446,242 @@ + + + + + + + + + + + + + + + + + + + + + +
  • + + + + + + + +
    + + + + + Tools + + + + + + + + +
    + + + +
    • + + + + + + +
  • diff --git a/how-to/data-hub/write-data.html b/how-to/data-hub/write-data.html index e2ed8cb..a4d9541 100644 --- a/how-to/data-hub/write-data.html +++ b/how-to/data-hub/write-data.html @@ -275,6 +275,26 @@ + + +
  • + + + + + + Tools + + +
    • + + + + + + + +
  • @@ -1407,6 +1427,242 @@ + + + + + + + + + + + + + + + + + + + + + +
  • + + + + + + + +
    + + + + + Tools + + + + + + + + +
    + + + +
    • + + + + + + +
  • diff --git a/how-to/platform/user-info.html b/how-to/platform/user-info.html index a92c685..1fa52f1 100644 --- a/how-to/platform/user-info.html +++ b/how-to/platform/user-info.html @@ -275,6 +275,26 @@ + + +
  • + + + + + + Tools + + +
    • + + + + + + + +
  • @@ -1372,6 +1392,242 @@ + + + + + + + + + + + + + + + + + + + + + +
  • + + + + + + + +
    + + + + + Tools + + + + + + + + +
    + + + +
    • + + + + + + +
  • diff --git a/how-to/platform/workstation-info.html b/how-to/platform/workstation-info.html index 3ba8e6a..02ffe86 100644 --- a/how-to/platform/workstation-info.html +++ b/how-to/platform/workstation-info.html @@ -275,6 +275,26 @@ + + +
  • + + + + + + Tools + + +
    • + + + + + + + +
  • @@ -1322,6 +1342,242 @@ + + + + + + + + + + + + + + + + + + + + + +
  • + + + + + + + +
    + + + + + Tools + + + + + + + + +
    + + + +
    • + + + + + + +
  • diff --git a/how-to/tools/list-tools.html b/how-to/tools/list-tools.html new file mode 100644 index 0000000..e22885d --- /dev/null +++ b/how-to/tools/list-tools.html @@ -0,0 +1,1760 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + List tools - CLI and Python client | Deep Origin + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    + +
    +
    + +
    + + + + +
    + + +
    + +
    + + + + + + + + + +
    +
    + + + +
    +
    +
    + + + + + + + +
    +
    +
    + + + +
    +
    +
    + + + + + +
    +
    +
    + + + +
    +
    + + + + + + + +

    List tools

    + +

    This document describes how to discover and list tools on the Deep Origin platform.

    +

    First, available tools are listed on the panel on left, with documentation on each tool and how to run them.

    +
    +

    Coming soon

    +

    More tools will be added soon. The ability to list tools from the API is coming soon.

    +
    + + + + + + + + + + + + + +
    +
    + + + + + +
    + + + +
    + + + +
    +
    +
    +
    + +
    + + + + + + + + + + \ No newline at end of file diff --git a/how-to/tools/run-tools.html b/how-to/tools/run-tools.html new file mode 100644 index 0000000..3b464f6 --- /dev/null +++ b/how-to/tools/run-tools.html @@ -0,0 +1,1755 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + Run tools - CLI and Python client | Deep Origin + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    + +
    +
    + +
    + + + + +
    + + +
    + +
    + + + + + + + + + +
    +
    + + + +
    +
    +
    + + + + + + + +
    +
    +
    + + + +
    +
    +
    + + + + + +
    +
    +
    + + + +
    +
    + + + + + + + +

    Run tools

    + +

    This document describes how to run tools on the Deep Origin platform.

    + + + + + + + + + + + + + +
    +
    + + + + + +
    + + + +
    + + + +
    +
    +
    +
    + +
    + + + + + + + + + + \ No newline at end of file diff --git a/index.html b/index.html index 293cd6f..b59bd99 100644 --- a/index.html +++ b/index.html @@ -273,6 +273,26 @@ + + +
  • + + + + + + Tools + + +
    • + + + + + + + +
  • @@ -1305,6 +1325,242 @@ + + + + + + + + + + + + + + + + + + + + + +
  • + + + + + + + +
    + + + + + Tools + + + + + + + + +
    + + + +
    • + + + + + + +
  • diff --git a/install.html b/install.html index 0b61aa1..071f7bb 100644 --- a/install.html +++ b/install.html @@ -275,6 +275,26 @@ + + +
  • + + + + + + Tools + + +
    • + + + + + + + +
  • @@ -1436,6 +1456,242 @@ + + + + + + + + + + + + + + + + + + + + + +
  • + + + + + + + +
    + + + + + Tools + + + + + + + + +
    + + + +
    • + + + + + + +
  • @@ -1611,14 +1867,14 @@

    On a Deep Origin workstationOn your local computer

    Run the command below for your favorite package manager to install the Deep Origin CLI and Python client.

    -
    +
    pip install deeporigin
    -
    pixi add deeporigin
+
    pixi add --pypi deeporigin
    @@ -1638,10 +1894,6 @@

    On your local computer

    -
    micromamba install -c https://repo.prefix.dev/deeporigin-public deeporigin
-
    -
    -
    flit install deeporigin
    diff --git a/objects.inv b/objects.inv index 78d860b..02e61ec 100644 Binary files a/objects.inv and b/objects.inv differ diff --git a/platform/index.html b/platform/index.html index baa0559..0f15224 100644 --- a/platform/index.html +++ b/platform/index.html @@ -275,6 +275,26 @@ + + +
  • + + + + + + Tools + + +
    • + + + + + + + +
  • @@ -1310,6 +1330,242 @@ + + + + + + + + + + + + + + + + + + + + + +
  • + + + + + + + +
    + + + + + Tools + + + + + + + + +
    + + + +
    • + + + + + + +
  • diff --git a/ref/data-hub/high-level-api.html b/ref/data-hub/high-level-api.html index 0a0a0c3..0e0a048 100644 --- a/ref/data-hub/high-level-api.html +++ b/ref/data-hub/high-level-api.html @@ -275,6 +275,26 @@ + + +
  • + + + + + + Tools + + +
    • + + + + + + + +
  • @@ -1567,6 +1587,242 @@ + + + + + + + + + + + + + + + + + + + + + +
  • + + + + + + + +
    + + + + + Tools + + + + + + + + +
    + + + +
    • + + + + + + +
  • diff --git a/ref/data-hub/low-level-api.html b/ref/data-hub/low-level-api.html index 2f098b9..c6fb046 100644 --- a/ref/data-hub/low-level-api.html +++ b/ref/data-hub/low-level-api.html @@ -275,6 +275,26 @@ + + +
  • + + + + + + Tools + + +
    • + + + + + + + +
  • @@ -1347,6 +1367,15 @@ +
    • + +
  • + + + describe_database_row + + +
  • @@ -1365,6 +1394,15 @@ +
    • + +
  • + + + describe_hierarchy + + +
  • @@ -1419,6 +1457,15 @@ +
    • + +
  • + + + export_database + + +
  • @@ -1509,6 +1556,15 @@ +
    • + +
  • + + + resolve_ids + + +
  • @@ -1740,6 +1796,15 @@ +
    • + +
  • + + + describe_database_row + + +
  • @@ -1758,6 +1823,15 @@ +
    • + +
  • + + + describe_hierarchy + + +
  • @@ -1812,6 +1886,15 @@ +
    • + +
  • + + + export_database + + +
  • @@ -1902,6 +1985,15 @@ +
    • + +
  • + + + resolve_ids + + +
  • @@ -2157,32 +2249,118 @@ -
  • - + + + + + + + + + + + + + + + + + + + +
  • + + + + + + +
    + + - Changelog + Tools - -
    • + + + + + +
    + +

    • - - - + -
    -
    -
    - - + - - -
  • - - - AsyncDeeporiginData - - +
    • - + +

    • + + + + + + + + + +
  • + + + + + Changelog + + + + +
    • + + + + + + + + + +
  • + + + + + Support + + + + +
    • + + + + + + + + + + + +
    +
    +
    + + + + +

    +
    describe_database_row(
     *,
-    database_id: str,
+    row_id: str,
+    column_selection: (
+        ColumnSelection | NotGiven
+    ) = NOT_GIVEN,
+    database_id: str | NotGiven = NOT_GIVEN,
     extra_headers: Headers | None = None,
     extra_query: Query | None = None,
     extra_body: Body | None = None,
     timeout: float | Timeout | None | NotGiven = NOT_GIVEN
-) -> DescribeDatabaseStatsResponse
+) -> DescribeDatabaseRowResponse
    -

    Returns aggregation information about a particular database.

    +

    Describe a database row

    Parameters:

    @@ -5164,10 +5570,26 @@

    - extra_headers + column_selection - Headers | None + ColumnSelection | NotGiven + + +
    +

    Select columns for inclusion/exclusion.

    +
    + + + NOT_GIVEN + + + + + extra_headers + + + Headers | None
    @@ -5236,28 +5658,28 @@

    -

    - describe_file +

    + describe_database_stats async -

    -
    describe_file(
+

    +
    describe_database_stats(
     *,
-    file_id: str,
+    database_id: str,
     extra_headers: Headers | None = None,
     extra_query: Query | None = None,
     extra_body: Body | None = None,
     timeout: float | Timeout | None | NotGiven = NOT_GIVEN
-) -> DescribeFileResponse
+) -> DescribeDatabaseStatsResponse
    -

    Describe a file by its ID.

    +

    Returns aggregation information about a particular database.

    Parameters:

    @@ -5271,22 +5693,6 @@

    - - file_id - - - str - - -
    -

    Deep Origin system ID.

    -
    - - - required - - extra_headers @@ -5361,34 +5767,28 @@

    -

    - describe_row +

    + describe_file async -

    -
    describe_row(
+
+
    describe_file(
     *,
-    row_id: str,
-    column_selection: (
-        ColumnSelection | NotGiven
-    ) = NOT_GIVEN,
-    fields: bool | NotGiven = NOT_GIVEN,
+    file_id: str,
     extra_headers: Headers | None = None,
     extra_query: Query | None = None,
     extra_body: Body | None = None,
     timeout: float | Timeout | None | NotGiven = NOT_GIVEN
-) -> DescribeRowResponse
+) -> DescribeFileResponse
 
    
 
     
    
 
-        
    Deprecated.
    
-
    Use DescribeDatabaseRow, DescribeDatabase, or DescribeWorkspace
-instead.
    
+        
    Describe a file by its ID.
    
 
 
 
    Parameters:
    
@@ -5404,18 +5804,18 @@ 
    
             
-                column_selection
+                file_id
             
             
-                  ColumnSelection | NotGiven
+                  str
             
             
               
    
-                
    Select columns for inclusion/exclusion.
    
+                
    Deep Origin system ID.
    
               
    
             
             
-                  NOT_GIVEN
+                required
             
           
           
@@ -5492,28 +5892,30 @@ 
    
 
 
-
    
-            describe_workspace
+
    
+            describe_hierarchy
 
 
   
       async
   
 
-
    
-
    describe_workspace(
+
+
    describe_hierarchy(
     *,
-    workspace_id: str,
+    id: str,
+    type: Literal["database", "row", "workspace"],
+    database_id: str | NotGiven = NOT_GIVEN,
     extra_headers: Headers | None = None,
     extra_query: Query | None = None,
     extra_body: Body | None = None,
     timeout: float | Timeout | None | NotGiven = NOT_GIVEN
-) -> DescribeWorkspaceResponse
+) -> DescribeHierarchyResponse
 
    
 
     
    
 
-        
    Describe a workspace
    
+        
    Describe the hierarchical position of an entity.
    
 
 
 
    Parameters:
    
@@ -5601,61 +6003,34 @@ 
    
 
 
-
    
-            download_file
-
-
-  
-      async
-  
-
-
    
-
    download_file(
-    *,
-    extra_headers: Headers | None = None,
-    extra_query: Query | None = None,
-    extra_body: Body | None = None,
-    timeout: float | Timeout | None | NotGiven = NOT_GIVEN
-) -> None
-
    
-
-    
    
-
-        
    Returns a 303 redirect to a pre-signed S3 URL.
    
-
-    
    
-
-
    
-
-
    
-
-
-
    
-            ensure_rows
+
    
+            describe_row
 
 
   
       async
   
 
-
    
-
    ensure_rows(
+
+
    describe_row(
     *,
-    database_id: str,
-    rows: Iterable[Row],
-    check_previous_value: bool | NotGiven = NOT_GIVEN,
+    row_id: str,
+    column_selection: (
+        ColumnSelection | NotGiven
+    ) = NOT_GIVEN,
+    fields: bool | NotGiven = NOT_GIVEN,
     extra_headers: Headers | None = None,
     extra_query: Query | None = None,
     extra_body: Body | None = None,
     timeout: float | Timeout | None | NotGiven = NOT_GIVEN
-) -> EnsureRowsResponse
+) -> DescribeRowResponse
 
    
 
     
    
 
-        
    Either creates or updates an existing row.
    
-
    Supports updates to both system and
-user defined columns.
    
+        
    Deprecated.
    
+
    Use DescribeDatabaseRow, DescribeDatabase, or DescribeWorkspace
+instead.
    
 
 
 
    Parameters:
    
@@ -5669,6 +6044,22 @@ 
    
+            
+                column_selection
+            
+            
+                  ColumnSelection | NotGiven
+            
+            
+              
    
+                
    Select columns for inclusion/exclusion.
    
+              
    
+            
+            
+                  NOT_GIVEN
+            
+          
           
             
                 extra_headers
@@ -5743,29 +6134,28 @@ 
    
 
 
-
    
-            execute_code_async
+
    
+            describe_workspace
 
 
   
       async
   
 
-
    
-
    execute_code_async(
+
+
    describe_workspace(
     *,
-    code: str,
-    code_language: Literal["python"],
+    workspace_id: str,
     extra_headers: Headers | None = None,
     extra_query: Query | None = None,
     extra_body: Body | None = None,
     timeout: float | Timeout | None | NotGiven = NOT_GIVEN
-) -> ExecuteCodeAsyncResponse
+) -> DescribeWorkspaceResponse
 
    
 
     
    
 
-        
    Execute code asynchronously.
    
+        
    Describe a workspace
    
 
 
 
    Parameters:
    
@@ -5853,29 +6243,28 @@ 
    
 
 
-
    
-            execute_code_sync
+
    
+            download_file
 
 
   
       async
   
 
-
    
-
    execute_code_sync(
+
+
    download_file(
     *,
-    code: str,
-    code_language: Literal["python"],
+    file_id: str,
     extra_headers: Headers | None = None,
     extra_query: Query | None = None,
     extra_body: Body | None = None,
     timeout: float | Timeout | None | NotGiven = NOT_GIVEN
-) -> ExecuteCodeSyncResponse
+) -> None
 
    
 
     
    
 
-        
    Execute code synchronously.
    
+        
    Returns a 303 redirect to a pre-signed S3 URL.
    
 
 
 
    Parameters:
    
@@ -5889,6 +6278,22 @@ 
    
+            
+                file_id
+            
+            
+                  str
+            
+            
+              
    
+                
    Deep Origin system ID.
    
+              
    
+            
+            
+                required
+            
+          
           
             
                 extra_headers
@@ -5963,28 +6368,32 @@ 
    
 
 
-
    
-            get_code_execution_result
+
    
+            ensure_rows
 
 
   
       async
   
 
-
    
-
    get_code_execution_result(
+
+
    ensure_rows(
     *,
-    id: str,
+    database_id: str,
+    rows: Iterable[Row],
+    check_previous_value: bool | NotGiven = NOT_GIVEN,
     extra_headers: Headers | None = None,
     extra_query: Query | None = None,
     extra_body: Body | None = None,
     timeout: float | Timeout | None | NotGiven = NOT_GIVEN
-) -> object
+) -> EnsureRowsResponse
 
    
 
     
    
 
-        
    Returns the result of a code execution.
    
+        
    Either creates or updates an existing row.
    
+
    Supports updates to both system and
+user defined columns.
    
 
 
 
    Parameters:
    
@@ -5998,22 +6407,6 @@ 
    
       
       
-          
-            
-                id
-            
-            
-                  str
-            
-            
-              
    
-                
    Deep Origin system ID.
    
-              
    
-            
-            
-                required
-            
-          
           
             
                 extra_headers
@@ -6088,31 +6481,29 @@ 
    
 
 
-
    
-            import_rows
+
    
+            execute_code_async
 
 
   
       async
   
 
-
    
-
    import_rows(
+
+
    execute_code_async(
     *,
-    database_id: str,
-    add_columns: Iterable[AddColumn] | NotGiven = NOT_GIVEN,
-    creation_block_id: str | NotGiven = NOT_GIVEN,
-    creation_parent_id: str | NotGiven = NOT_GIVEN,
+    code: str,
+    code_language: Literal["python"],
     extra_headers: Headers | None = None,
     extra_query: Query | None = None,
     extra_body: Body | None = None,
     timeout: float | Timeout | None | NotGiven = NOT_GIVEN
-) -> ImportRowsResponse
+) -> ExecuteCodeAsyncResponse
 
    
 
     
    
 
-        
    Creates new rows from CSV data.
    
+        
    Execute code asynchronously.
    
 
 
 
    Parameters:
    
@@ -6128,30 +6519,14 @@ 
    
             
-                add_columns
+                extra_headers
             
             
-                  Iterable[AddColumn] | NotGiven
+                  Headers | None
             
             
               
    
-                
    Optionally add additional columns to the database during import.
    
-              
    
-            
-            
-                  NOT_GIVEN
-            
-          
-          
-            
-                extra_headers
-            
-            
-                  Headers | None
-            
-            
-              
    
-                
    Send extra headers
    
+                
    Send extra headers
    
               
    
             
             
@@ -6216,29 +6591,29 @@ 
    
 
 
-
    
-            list_database_column_unique_values_v2
+
    
+            execute_code_sync
 
 
   
       async
   
 
-
    
-
    list_database_column_unique_values_v2(
+
+
    execute_code_sync(
     *,
-    column_id: str,
-    database_id: str,
+    code: str,
+    code_language: Literal["python"],
     extra_headers: Headers | None = None,
     extra_query: Query | None = None,
     extra_body: Body | None = None,
     timeout: float | Timeout | None | NotGiven = NOT_GIVEN
-) -> ListDatabaseColumnUniqueValuesV2Response
+) -> ExecuteCodeSyncResponse
 
    
 
     
    
 
-        
    Returns the unique values for every cell within the column.
    
+        
    Execute code synchronously.
    
 
 
 
    Parameters:
    
@@ -6326,35 +6701,34 @@ 
    
 
 
-
    
-            list_database_rows
+
    
+            export_database
 
 
   
       async
   
 
-
    
-
    list_database_rows(
+
+
    export_database(
     *,
-    database_row_id: str,
+    database_id: str,
+    format: Literal["csv"],
     column_selection: (
-        ColumnSelection | NotGiven
+        ColumnSelection | NotGiven
     ) = NOT_GIVEN,
-    filter: Filter | NotGiven = NOT_GIVEN,
-    limit: int | NotGiven = NOT_GIVEN,
-    offset: int | NotGiven = NOT_GIVEN,
-    row_sort: Iterable[RowSort] | NotGiven = NOT_GIVEN,
+    filter: Filter | NotGiven = NOT_GIVEN,
+    row_sort: Iterable[RowSort] | NotGiven = NOT_GIVEN,
     extra_headers: Headers | None = None,
     extra_query: Query | None = None,
     extra_body: Body | None = None,
     timeout: float | Timeout | None | NotGiven = NOT_GIVEN
-) -> ListDatabaseRowsResponse
+) -> AsyncBinaryAPIResponse
 
    
 
     
    
 
-        
    List database rows with full row data.
    
+        
    Exports a database to a file.
    
 
 
 
    Parameters:
    
@@ -6373,7 +6747,7 @@ 
    ColumnSelection | NotGiven
+                  ColumnSelection | NotGiven
             
             
               
    
@@ -6389,7 +6763,7 @@ 
    Iterable[RowSort] | NotGiven
+                  Iterable[RowSort] | NotGiven
             
             
               
    
@@ -6474,28 +6848,28 @@ 
    
 
 
-
    
-            list_files
+
    
+            get_code_execution_result
 
 
   
       async
   
 
-
    
-
    list_files(
+
    
+
    get_code_execution_result(
     *,
-    filters: Iterable[Filter] | NotGiven = NOT_GIVEN,
+    id: str,
     extra_headers: Headers | None = None,
     extra_query: Query | None = None,
     extra_body: Body | None = None,
     timeout: float | Timeout | None | NotGiven = NOT_GIVEN
-) -> ListFilesResponse
+) -> object
 
    
 
     
    
 
-        
    Returns a list of files using the filters.
    
+        
    Returns the result of a code execution.
    
 
 
 
    Parameters:
    
@@ -6509,6 +6883,22 @@ 
    
+            
+                id
+            
+            
+                  str
+            
+            
+              
    
+                
    Deep Origin system ID.
    
+              
    
+            
+            
+                required
+            
+          
           
             
                 extra_headers
@@ -6583,28 +6973,31 @@ 
    
 
 
-
    
-            list_mentions
+
    
+            import_rows
 
 
   
       async
   
 
-
    
-
    list_mentions(
+
    
+
    import_rows(
     *,
-    query: str,
+    database_id: str,
+    add_columns: Iterable[AddColumn] | NotGiven = NOT_GIVEN,
+    creation_block_id: str | NotGiven = NOT_GIVEN,
+    creation_parent_id: str | NotGiven = NOT_GIVEN,
     extra_headers: Headers | None = None,
     extra_query: Query | None = None,
     extra_body: Body | None = None,
     timeout: float | Timeout | None | NotGiven = NOT_GIVEN
-) -> ListMentionsResponse
+) -> ImportRowsResponse
 
    
 
     
    
 
-        
    Returns entities that can be mentioned in a notebook.
    
+        
    Creates new rows from CSV data.
    
 
 
 
    Parameters:
    
@@ -6618,6 +7011,22 @@ 
    
+            
+                add_columns
+            
+            
+                  Iterable[AddColumn] | NotGiven
+            
+            
+              
    
+                
    Optionally add additional columns to the database during import.
    
+              
    
+            
+            
+                  NOT_GIVEN
+            
+          
           
             
                 extra_headers
@@ -6692,29 +7101,29 @@ 
    
 
 
-
    
-            list_row_back_references
+
    
+            list_database_column_unique_values_v2
 
 
   
       async
   
 
-
    
-
    list_row_back_references(
+
+
    list_database_column_unique_values_v2(
     *,
+    column_id: str,
     database_id: str,
-    row_id: str,
     extra_headers: Headers | None = None,
     extra_query: Query | None = None,
     extra_body: Body | None = None,
     timeout: float | Timeout | None | NotGiven = NOT_GIVEN
-) -> ListRowBackReferencesResponse
+) -> ListDatabaseColumnUniqueValuesV2Response
 
    
 
     
    
 
-        
    Finds all the places a row is referenced.
    
+        
    Returns the unique values for every cell within the column.
    
 
 
 
    Parameters:
    
@@ -6802,28 +7211,35 @@ 
    
 
 
-
    
-            list_rows
+
    
+            list_database_rows
 
 
   
       async
   
 
-
    
-
    list_rows(
+
+
    list_database_rows(
     *,
-    filters: Iterable[Filter],
+    database_row_id: str,
+    column_selection: (
+        ColumnSelection | NotGiven
+    ) = NOT_GIVEN,
+    filter: Filter | NotGiven = NOT_GIVEN,
+    limit: int | NotGiven = NOT_GIVEN,
+    offset: int | NotGiven = NOT_GIVEN,
+    row_sort: Iterable[RowSort] | NotGiven = NOT_GIVEN,
     extra_headers: Headers | None = None,
     extra_query: Query | None = None,
     extra_body: Body | None = None,
     timeout: float | Timeout | None | NotGiven = NOT_GIVEN
-) -> ListRowsResponse
+) -> ListDatabaseRowsResponse
 
    
 
     
    
 
-        
    Lists rows at a given depth in the hierarchy.
    
+        
    List database rows with full row data.
    
 
 
 
    Parameters:
    
@@ -6837,6 +7253,38 @@ 
    
+            
+                column_selection
+            
+            
+                  ColumnSelection | NotGiven
+            
+            
+              
    
+                
    Select columns for inclusion/exclusion.
    
+              
    
+            
+            
+                  NOT_GIVEN
+            
+          
+          
+            
+                row_sort
+            
+            
+                  Iterable[RowSort] | NotGiven
+            
+            
+              
    
+                
    Sort rows by column.
    
+              
    
+            
+            
+                  NOT_GIVEN
+            
+          
           
             
                 extra_headers
@@ -6911,28 +7359,28 @@ 
    
 
 
-
    
-            lock_database
+
    
+            list_files
 
 
   
       async
   
 
-
    
-
    lock_database(
+
+
    list_files(
     *,
-    database_id: str,
+    filters: Iterable[Filter] | NotGiven = NOT_GIVEN,
     extra_headers: Headers | None = None,
     extra_query: Query | None = None,
     extra_body: Body | None = None,
     timeout: float | Timeout | None | NotGiven = NOT_GIVEN
-) -> LockDatabaseResponse
+) -> ListFilesResponse
 
    
 
     
    
 
-        
    A locked database cannot be edited.
    
+        
    Returns a list of files using the filters.
    
 
 
 
    Parameters:
    
@@ -7020,28 +7468,28 @@ 
    
 
 
-
    
-            parse_base_sequence_data
+
    
+            list_mentions
 
 
   
       async
   
 
-
    
-
    parse_base_sequence_data(
+
+
    list_mentions(
     *,
-    file_id: str,
+    query: str,
     extra_headers: Headers | None = None,
     extra_query: Query | None = None,
     extra_body: Body | None = None,
     timeout: float | Timeout | None | NotGiven = NOT_GIVEN
-) -> ParseBaseSequenceDataResponse
+) -> ListMentionsResponse
 
    
 
     
    
 
-        
    Parses a base sequence file and returns the parsed result.
    
+        
    Returns entities that can be mentioned in a notebook.
    
 
 
 
    Parameters:
    
@@ -7129,28 +7577,29 @@ 
    
 
 
-
    
-            unlock_database
+
    
+            list_row_back_references
 
 
   
       async
   
 
-
    
-
    unlock_database(
+
+
    list_row_back_references(
     *,
     database_id: str,
+    row_id: str,
     extra_headers: Headers | None = None,
     extra_query: Query | None = None,
     extra_body: Body | None = None,
     timeout: float | Timeout | None | NotGiven = NOT_GIVEN
-) -> UnlockDatabaseResponse
+) -> ListRowBackReferencesResponse
 
    
 
     
    
 
-        
    An unlocked database can be edited.
    
+        
    Finds all the places a row is referenced.
    
 
 
 
    Parameters:
    
@@ -7238,29 +7687,28 @@ 
    
 
 
-
    
-            update_database
+
    
+            list_rows
 
 
   
       async
   
 
-
    
-
    update_database(
+
+
    list_rows(
     *,
-    id: str,
-    database: Database,
+    filters: Iterable[Filter],
     extra_headers: Headers | None = None,
     extra_query: Query | None = None,
     extra_body: Body | None = None,
     timeout: float | Timeout | None | NotGiven = NOT_GIVEN
-) -> UpdateDatabaseResponse
+) -> ListRowsResponse
 
    
 
     
    
 
-        
    Update a database.
    
+        
    Lists rows at a given depth in the hierarchy.
    
 
 
 
    Parameters:
    
@@ -7348,30 +7796,28 @@ 
    
 
 
-
    
-            update_database_column
+
    
+            lock_database
 
 
   
       async
   
 
-
    
-
    update_database_column(
+
+
    lock_database(
     *,
-    column: Column,
-    column_id: str,
     database_id: str,
     extra_headers: Headers | None = None,
     extra_query: Query | None = None,
     extra_body: Body | None = None,
     timeout: float | Timeout | None | NotGiven = NOT_GIVEN
-) -> UpdateDatabaseColumnResponse
+) -> LockDatabaseResponse
 
    
 
     
    
 
-        
    Update a column in a database.
    
+        
    A locked database cannot be edited.
    
 
 
 
    Parameters:
    
@@ -7459,29 +7905,28 @@ 
    
 
 
-
    
-            update_workspace
+
    
+            parse_base_sequence_data
 
 
   
       async
   
 
-
    
-
    update_workspace(
+
+
    parse_base_sequence_data(
     *,
-    id: str,
-    workspace: Workspace,
+    file_id: str,
     extra_headers: Headers | None = None,
     extra_query: Query | None = None,
     extra_body: Body | None = None,
     timeout: float | Timeout | None | NotGiven = NOT_GIVEN
-) -> UpdateWorkspaceResponse
+) -> ParseBaseSequenceDataResponse
 
    
 
     
    
 
-        
    Update a workspace.
    
+        
    Parses a base sequence file and returns the parsed result.
    
 
 
 
    Parameters:
    
@@ -7566,77 +8011,221 @@ 
    
 
 
-  
    
-
-    
    
-
-
    
-
-
    
-
-
-
-
    
-            DeeporiginData
+
    
+            resolve_ids
 
 
-
    
+  
+      async
+  
 
+
+
    resolve_ids(
+    *,
+    database_ids: List[str] | NotGiven = NOT_GIVEN,
+    rows: Iterable[Row] | NotGiven = NOT_GIVEN,
+    workspace_ids: List[str] | NotGiven = NOT_GIVEN,
+    extra_headers: Headers | None = None,
+    extra_query: Query | None = None,
+    extra_body: Body | None = None,
+    timeout: float | Timeout | None | NotGiven = NOT_GIVEN
+) -> ResolveIDsResponse
+
    
 
     
    
-            
    
-              Bases: SyncAPIClient
    
-
-
-
-
-
-
-
-
-
-
-  
    
-
-
-
 
+        
    Resolves between system IDs and human IDs (HIDs).
    
 
 
+
    Parameters:
    
+    
+      
+        
+          
+          
+          
+          
+        
+      
+      
+          
+            
+            
+            
+            
+          
+          
+            
+            
+            
+            
+          
+          
+            
+            
+            
+            
+          
+          
+            
+            
+            
+            
+          
+      
+    
    NameTypeDescriptionDefault
    
+                extra_headers
+            
+                  Headers | None
+            
+              
    
+                
    Send extra headers
    
+              
    
+                		
+                  None
+            
    
+                extra_query
+            
+                  Query | None
+            
+              
    
+                
    Add additional query parameters to the request
    
+              
    
+                		
+                  None
+            
    
+                extra_body
+            
+                  Body | None
+            
+              
    
+                
    Add additional JSON properties to the request
    
+              
    
+                		
+                  None
+            
    
+                timeout
+            
+                  float | Timeout | None | NotGiven
+            
+              
    
+                
    Override the client-level default timeout for this request, in seconds
    
+              
    
+                		
+                  NOT_GIVEN
+            
    
 
+    
    
 
+
    
 
 
    
 
 
-
    
-            __init__
+
    
+            unlock_database
 
 
-
    
-
    __init__(
+  
+      async
+  
+
+
+
    unlock_database(
     *,
-    token: str | None = None,
-    org_id: str | None = None,
-    base_url: str | URL | None = None,
-    timeout: Union[
-        float, Timeout, None, NotGiven
-    ] = NOT_GIVEN,
-    max_retries: int = DEFAULT_MAX_RETRIES,
-    default_headers: Mapping[str, str] | None = None,
-    default_query: Mapping[str, object] | None = None,
-    http_client: Client | None = None,
-    _strict_response_validation: bool = False
-) -> None
+    database_id: str,
+    extra_headers: Headers | None = None,
+    extra_query: Query | None = None,
+    extra_body: Body | None = None,
+    timeout: float | Timeout | None | NotGiven = NOT_GIVEN
+) -> UnlockDatabaseResponse
 
    
 
     
    
 
-        
    This automatically infers the following arguments from their corresponding environment variables if they are not provided:
-- token from ORG_BEARER_TOKEN
-- org_id from ORG_ID
    
+        
    An unlocked database can be edited.
    
+
+
+
    Parameters:
    
+    
+      
+        
+          
+          
+          
+          
+        
+      
+      
+          
+            
+            
+            
+            
+          
+          
+            
+            
+            
+            
+          
+          
+            
+            
+            
+            
+          
+          
+            
+            
+            
+            
+          
+      
+    
    NameTypeDescriptionDefault
    
+                extra_headers
+            
+                  Headers | None
+            
+              
    
+                
    Send extra headers
    
+              
    
+                		
+                  None
+            
    
+                extra_query
+            
+                  Query | None
+            
+              
    
+                
    Add additional query parameters to the request
    
+              
    
+                		
+                  None
+            
    
+                extra_body
+            
+                  Body | None
+            
+              
    
+                
    Add additional JSON properties to the request
    
+              
    
+                		
+                  None
+            
    
+                timeout
+            
+                  float | Timeout | None | NotGiven
+            
+              
    
+                
    Override the client-level default timeout for this request, in seconds
    
+              
    
+                		
+                  NOT_GIVEN
+            
    
 
     
    
 
@@ -7645,25 +8234,432 @@ 
    
 
 
-
    
-            add_database_column
+
    
+            update_database
 
 
-
    
-
    add_database_column(
+  
+      async
+  
+
+
+
    update_database(
     *,
-    column: Column,
-    database_id: str,
+    id: str,
+    database: Database,
     extra_headers: Headers | None = None,
     extra_query: Query | None = None,
     extra_body: Body | None = None,
     timeout: float | Timeout | None | NotGiven = NOT_GIVEN
-) -> AddDatabaseColumnResponse
+) -> UpdateDatabaseResponse
 
    
 
     
    
 
-        
    Add a column to a database.
    
+        
    Update a database.
    
+
+
+
    Parameters:
    
+    
+      
+        
+          
+          
+          
+          
+        
+      
+      
+          
+            
+            
+            
+            
+          
+          
+            
+            
+            
+            
+          
+          
+            
+            
+            
+            
+          
+          
+            
+            
+            
+            
+          
+      
+    
    NameTypeDescriptionDefault
    
+                extra_headers
+            
+                  Headers | None
+            
+              
    
+                
    Send extra headers
    
+              
    
+                		
+                  None
+            
    
+                extra_query
+            
+                  Query | None
+            
+              
    
+                
    Add additional query parameters to the request
    
+              
    
+                		
+                  None
+            
    
+                extra_body
+            
+                  Body | None
+            
+              
    
+                
    Add additional JSON properties to the request
    
+              
    
+                		
+                  None
+            
    
+                timeout
+            
+                  float | Timeout | None | NotGiven
+            
+              
    
+                
    Override the client-level default timeout for this request, in seconds
    
+              
    
+                		
+                  NOT_GIVEN
+            
    
+
+    
    
+
+
    
+
+
    
+
+
+
    
+            update_database_column
+
+
+  
+      async
+  
+
+
    
+
    update_database_column(
+    *,
+    column: Column,
+    column_id: str,
+    database_id: str,
+    extra_headers: Headers | None = None,
+    extra_query: Query | None = None,
+    extra_body: Body | None = None,
+    timeout: float | Timeout | None | NotGiven = NOT_GIVEN
+) -> UpdateDatabaseColumnResponse
+
    
+
+    
    
+
+        
    Update a column in a database.
    
+
+
+
    Parameters:
    
+    
+      
+        
+          
+          
+          
+          
+        
+      
+      
+          
+            
+            
+            
+            
+          
+          
+            
+            
+            
+            
+          
+          
+            
+            
+            
+            
+          
+          
+            
+            
+            
+            
+          
+      
+    
    NameTypeDescriptionDefault
    
+                extra_headers
+            
+                  Headers | None
+            
+              
    
+                
    Send extra headers
    
+              
    
+                		
+                  None
+            
    
+                extra_query
+            
+                  Query | None
+            
+              
    
+                
    Add additional query parameters to the request
    
+              
    
+                		
+                  None
+            
    
+                extra_body
+            
+                  Body | None
+            
+              
    
+                
    Add additional JSON properties to the request
    
+              
    
+                		
+                  None
+            
    
+                timeout
+            
+                  float | Timeout | None | NotGiven
+            
+              
    
+                
    Override the client-level default timeout for this request, in seconds
    
+              
    
+                		
+                  NOT_GIVEN
+            
    
+
+    
    
+
+
    
+
+
    
+
+
+
    
+            update_workspace
+
+
+  
+      async
+  
+
+
    
+
    update_workspace(
+    *,
+    id: str,
+    workspace: Workspace,
+    extra_headers: Headers | None = None,
+    extra_query: Query | None = None,
+    extra_body: Body | None = None,
+    timeout: float | Timeout | None | NotGiven = NOT_GIVEN
+) -> UpdateWorkspaceResponse
+
    
+
+    
    
+
+        
    Update a workspace.
    
+
+
+
    Parameters:
    
+    
+      
+        
+          
+          
+          
+          
+        
+      
+      
+          
+            
+            
+            
+            
+          
+          
+            
+            
+            
+            
+          
+          
+            
+            
+            
+            
+          
+          
+            
+            
+            
+            
+          
+      
+    
    NameTypeDescriptionDefault
    
+                extra_headers
+            
+                  Headers | None
+            
+              
    
+                
    Send extra headers
    
+              
    
+                		
+                  None
+            
    
+                extra_query
+            
+                  Query | None
+            
+              
    
+                
    Add additional query parameters to the request
    
+              
    
+                		
+                  None
+            
    
+                extra_body
+            
+                  Body | None
+            
+              
    
+                
    Add additional JSON properties to the request
    
+              
    
+                		
+                  None
+            
    
+                timeout
+            
+                  float | Timeout | None | NotGiven
+            
+              
    
+                
    Override the client-level default timeout for this request, in seconds
    
+              
    
+                		
+                  NOT_GIVEN
+            
    
+
+    
    
+
+
    
+
+
+
+  
    
+
+    
    
+
+
    
+
+
    
+
+
+
+
    
+            DeeporiginData
+
+
+
    
+
+
+    
    
+            
    
+              Bases: SyncAPIClient
    
+
+
+
+
+
+
+
+
+
+
+  
    
+
+
+
+
+
+
+
+
+
+
    
+
+
+
    
+            __init__
+
+
+
    
+
    __init__(
+    *,
+    token: str | None = None,
+    org_id: str | None = None,
+    base_url: str | URL | None = None,
+    timeout: Union[
+        float, Timeout, None, NotGiven
+    ] = NOT_GIVEN,
+    max_retries: int = DEFAULT_MAX_RETRIES,
+    default_headers: Mapping[str, str] | None = None,
+    default_query: Mapping[str, object] | None = None,
+    http_client: Client | None = None,
+    _strict_response_validation: bool = False
+) -> None
+
    
+
+    
    
+
+        
    This automatically infers the following arguments from their corresponding environment variables if they are not provided:
+- token from ORG_BEARER_TOKEN
+- org_id from ORG_ID
    
+
+    
    
+
+
    
+
+
    
+
+
+
    
+            add_database_column
+
+
+
    
+
    add_database_column(
+    *,
+    column: Column,
+    database_id: str,
+    extra_headers: Headers | None = None,
+    extra_query: Query | None = None,
+    extra_body: Body | None = None,
+    timeout: float | Timeout | None | NotGiven = NOT_GIVEN
+) -> AddDatabaseColumnResponse
+
    
+
+    
    
+
+        
    Add a column to a database.
    
 
 
 
    Parameters:
    
@@ -7755,20 +8751,465 @@ 
                archive_files
 
 
-
    
-
    archive_files(
+
+
    archive_files(
+    *,
+    file_ids: List[str],
+    extra_headers: Headers | None = None,
+    extra_query: Query | None = None,
+    extra_body: Body | None = None,
+    timeout: float | Timeout | None | NotGiven = NOT_GIVEN
+) -> object
+
    
+
+    
    
+
+        
    Archive files by their ids.
    
+
+
+
    Parameters:
    
+    
+      
+        
+          
+          
+          
+          
+        
+      
+      
+          
+            
+            
+            
+            
+          
+          
+            
+            
+            
+            
+          
+          
+            
+            
+            
+            
+          
+          
+            
+            
+            
+            
+          
+      
+    
    NameTypeDescriptionDefault
    
+                extra_headers
+            
+                  Headers | None
+            
+              
    
+                
    Send extra headers
    
+              
    
+                		
+                  None
+            
    
+                extra_query
+            
+                  Query | None
+            
+              
    
+                
    Add additional query parameters to the request
    
+              
    
+                		
+                  None
+            
    
+                extra_body
+            
+                  Body | None
+            
+              
    
+                
    Add additional JSON properties to the request
    
+              
    
+                		
+                  None
+            
    
+                timeout
+            
+                  float | Timeout | None | NotGiven
+            
+              
    
+                
    Override the client-level default timeout for this request, in seconds
    
+              
    
+                		
+                  NOT_GIVEN
+            
    
+
+    
    
+
+
    
+
+
    
+
+
+
    
+            chat_create_thread
+
+
+
    
+
    chat_create_thread(
+    *,
+    body: object,
+    extra_headers: Headers | None = None,
+    extra_query: Query | None = None,
+    extra_body: Body | None = None,
+    timeout: float | Timeout | None | NotGiven = NOT_GIVEN
+) -> ChatCreateThreadResponse
+
    
+
+    
    
+
+        
    Create a new chat thread.
    
+
+
+
    Parameters:
    
+    
+      
+        
+          
+          
+          
+          
+        
+      
+      
+          
+            
+            
+            
+            
+          
+          
+            
+            
+            
+            
+          
+          
+            
+            
+            
+            
+          
+          
+            
+            
+            
+            
+          
+      
+    
    NameTypeDescriptionDefault
    
+                extra_headers
+            
+                  Headers | None
+            
+              
    
+                
    Send extra headers
    
+              
    
+                		
+                  None
+            
    
+                extra_query
+            
+                  Query | None
+            
+              
    
+                
    Add additional query parameters to the request
    
+              
    
+                		
+                  None
+            
    
+                extra_body
+            
+                  Body | None
+            
+              
    
+                
    Add additional JSON properties to the request
    
+              
    
+                		
+                  None
+            
    
+                timeout
+            
+                  float | Timeout | None | NotGiven
+            
+              
    
+                
    Override the client-level default timeout for this request, in seconds
    
+              
    
+                		
+                  NOT_GIVEN
+            
    
+
+    
    
+
+
    
+
+
    
+
+
+
    
+            chat_list_messages
+
+
+
    
+
    chat_list_messages(
+    *,
+    thread_id: str,
+    extra_headers: Headers | None = None,
+    extra_query: Query | None = None,
+    extra_body: Body | None = None,
+    timeout: float | Timeout | None | NotGiven = NOT_GIVEN
+) -> ChatListMessagesResponse
+
    
+
+    
    
+
+        
    List messages in a chat thread.
    
+
+
+
    Parameters:
    
+    
+      
+        
+          
+          
+          
+          
+        
+      
+      
+          
+            
+            
+            
+            
+          
+          
+            
+            
+            
+            
+          
+          
+            
+            
+            
+            
+          
+          
+            
+            
+            
+            
+          
+      
+    
    NameTypeDescriptionDefault
    
+                extra_headers
+            
+                  Headers | None
+            
+              
    
+                
    Send extra headers
    
+              
    
+                		
+                  None
+            
    
+                extra_query
+            
+                  Query | None
+            
+              
    
+                
    Add additional query parameters to the request
    
+              
    
+                		
+                  None
+            
    
+                extra_body
+            
+                  Body | None
+            
+              
    
+                
    Add additional JSON properties to the request
    
+              
    
+                		
+                  None
+            
    
+                timeout
+            
+                  float | Timeout | None | NotGiven
+            
+              
    
+                
    Override the client-level default timeout for this request, in seconds
    
+              
    
+                		
+                  NOT_GIVEN
+            
    
+
+    
    
+
+
    
+
+
    
+
+
+
    
+            chat_send_message
+
+
+
    
+
    chat_send_message(
+    *,
+    messages: Iterable[Message],
+    thread_id: str,
+    context: Context | NotGiven = NOT_GIVEN,
+    extra_headers: Headers | None = None,
+    extra_query: Query | None = None,
+    extra_body: Body | None = None,
+    timeout: float | Timeout | None | NotGiven = NOT_GIVEN
+) -> None
+
    
+
+    
    
+
+        
    Send a chat message to the Deep Origin assistant and streams results via SSE.
    
+
+
+
    Parameters:
    
+    
+      
+        
+          
+          
+          
+          
+        
+      
+      
+          
+            
+            
+            
+            
+          
+          
+            
+            
+            
+            
+          
+          
+            
+            
+            
+            
+          
+          
+            
+            
+            
+            
+          
+      
+    
    NameTypeDescriptionDefault
    
+                extra_headers
+            
+                  Headers | None
+            
+              
    
+                
    Send extra headers
    
+              
    
+                		
+                  None
+            
    
+                extra_query
+            
+                  Query | None
+            
+              
    
+                
    Add additional query parameters to the request
    
+              
    
+                		
+                  None
+            
    
+                extra_body
+            
+                  Body | None
+            
+              
    
+                
    Add additional JSON properties to the request
    
+              
    
+                		
+                  None
+            
    
+                timeout
+            
+                  float | Timeout | None | NotGiven
+            
+              
    
+                
    Override the client-level default timeout for this request, in seconds
    
+              
    
+                		
+                  NOT_GIVEN
+            
    
+
+    
    
+
+
    
+
+
    
+
+
+
    
+            close
+
+
+
    
+
    close() -> None
+
    
+
+    
    
+
+        
    Close the underlying HTTPX client.
    
+
    The client will not be usable after this.
    
+
+    
    
+
+
    
+
+
    
+
+
+
    
+            configure_column_select_options
+
+
+
    
+
    configure_column_select_options(
     *,
-    file_ids: List[str],
+    column_id: str,
+    database_id: str,
+    option_configuration: Iterable[OptionConfiguration],
     extra_headers: Headers | None = None,
     extra_query: Query | None = None,
     extra_body: Body | None = None,
     timeout: float | Timeout | None | NotGiven = NOT_GIVEN
-) -> object
+) -> ConfigureColumnSelectOptionsResponse
 
    
 
     
    
 
-        
    Archive files by their ids.
    
+        
    Configure column select options.
    
+
    Supports both adding and removing options.
    
 
 
 
    Parameters:
    
@@ -7856,24 +9297,26 @@ 
    
 
 
-
    
-            chat_create_thread
+
    
+            convert_id_format
 
 
-
    
-
    chat_create_thread(
+
+
    convert_id_format(
     *,
-    body: object,
+    conversions: Iterable[Conversion],
     extra_headers: Headers | None = None,
     extra_query: Query | None = None,
     extra_body: Body | None = None,
     timeout: float | Timeout | None | NotGiven = NOT_GIVEN
-) -> ChatCreateThreadResponse
+) -> ConvertIDFormatResponse
 
    
 
     
    
 
-        
    Create a new chat thread.
    
+        
    Converts between system IDs and human IDs (HIDs).
    
+
    Deprecated - prefer
+ResolveIds.
    
 
 
 
    Parameters:
    
@@ -7961,24 +9404,56 @@ 
    
 
 
-
    
-            chat_list_messages
+
    
+            copy
 
 
-
    
-
    chat_list_messages(
+
+
    copy(
     *,
-    thread_id: str,
+    token: str | None = None,
+    org_id: str | None = None,
+    base_url: str | URL | None = None,
+    timeout: float | Timeout | None | NotGiven = NOT_GIVEN,
+    http_client: Client | None = None,
+    max_retries: int | NotGiven = NOT_GIVEN,
+    default_headers: Mapping[str, str] | None = None,
+    set_default_headers: Mapping[str, str] | None = None,
+    default_query: Mapping[str, object] | None = None,
+    set_default_query: Mapping[str, object] | None = None,
+    _extra_kwargs: Mapping[str, Any] = {}
+) -> Self
+
    
+
+    
    
+
+        
    Create a new client instance re-using the same options given to the current client with optional overriding.
    
+
+    
    
+
+
    
+
+
    
+
+
+
    
+            create_database
+
+
+
    
+
    create_database(
+    *,
+    database: Database,
     extra_headers: Headers | None = None,
     extra_query: Query | None = None,
     extra_body: Body | None = None,
     timeout: float | Timeout | None | NotGiven = NOT_GIVEN
-) -> ChatListMessagesResponse
+) -> CreateDatabaseResponse
 
    
 
     
    
 
-        
    List messages in a chat thread.
    
+        
    Create a new database.
    
 
 
 
    Parameters:
    
@@ -8066,26 +9541,24 @@ 
    
 
 
-
    
-            chat_send_message
+
    
+            create_file_download_url
 
 
-
    
-
    chat_send_message(
+
+
    create_file_download_url(
     *,
-    messages: Iterable[Message],
-    thread_id: str,
-    context: Context | NotGiven = NOT_GIVEN,
+    file_id: str,
     extra_headers: Headers | None = None,
     extra_query: Query | None = None,
     extra_body: Body | None = None,
     timeout: float | Timeout | None | NotGiven = NOT_GIVEN
-) -> None
+) -> CreateFileDownloadURLResponse
 
    
 
     
    
 
-        
    Send a chat message to the Deep Origin assistant and streams results via SSE.
    
+        
    Returns a pre-signed S3 URL.
    
 
 
 
    Parameters:
    
@@ -8099,6 +9572,22 @@ 
    
+            
+                file_id
+            
+            
+                  str
+            
+            
+              
    
+                
    Deep Origin system ID.
    
+              
    
+            
+            
+                required
+            
+          
           
             
                 extra_headers
@@ -8173,47 +9662,28 @@ 
    
 
 
-
    
-            close
-
-
-
    
-
    close() -> None
-
    
-
-    
    
-
-        
    Close the underlying HTTPX client.
    
-
    The client will not be usable after this.
    
-
-    
    
-
-
    
-
-
    
-
-
-
    
-            configure_column_select_options
+
    
+            create_file_upload
 
 
-
    
-
    configure_column_select_options(
+
+
    create_file_upload(
     *,
-    column_id: str,
-    database_id: str,
-    option_configuration: Iterable[OptionConfiguration],
+    content_length: str,
+    name: str,
+    checksum_sha256: str | NotGiven = NOT_GIVEN,
+    content_type: str | NotGiven = NOT_GIVEN,
     extra_headers: Headers | None = None,
     extra_query: Query | None = None,
     extra_body: Body | None = None,
     timeout: float | Timeout | None | NotGiven = NOT_GIVEN
-) -> ConfigureColumnSelectOptionsResponse
+) -> CreateFileUploadResponse
 
    
 
     
    
 
-        
    Configure column select options.
    
-
    Supports both adding and removing options.
    
+        
    Create a file upload URL.
    
+
    Typically this is creating a pre-signed S3 URL.
    
 
 
 
    Parameters:
    
@@ -8227,6 +9697,22 @@ 
    
       
       
+          
+            
+                checksum_sha256
+            
+            
+                  str | NotGiven
+            
+            
+              
    
+                
    Base64 encoded SHA256 checksum of the file.
    
+              
    
+            
+            
+                  NOT_GIVEN
+            
+          
           
             
                 extra_headers
@@ -8301,24 +9787,24 @@ 
    
 
 
-
    
-            convert_id_format
+
    
+            create_workspace
 
 
-
    
-
    convert_id_format(
+
+
    create_workspace(
     *,
-    conversions: Iterable[Conversion],
+    workspace: Workspace,
     extra_headers: Headers | None = None,
     extra_query: Query | None = None,
     extra_body: Body | None = None,
     timeout: float | Timeout | None | NotGiven = NOT_GIVEN
-) -> ConvertIDFormatResponse
+) -> CreateWorkspaceResponse
 
    
 
     
    
 
-        
    Converts between system IDs and human IDs (HIDs).
    
+        
    Create a new workspace.
    
 
 
 
    Parameters:
    
@@ -8406,56 +9892,24 @@ 
    
 
 
-
    
-            copy
-
-
-
    
-
    copy(
-    *,
-    token: str | None = None,
-    org_id: str | None = None,
-    base_url: str | URL | None = None,
-    timeout: float | Timeout | None | NotGiven = NOT_GIVEN,
-    http_client: Client | None = None,
-    max_retries: int | NotGiven = NOT_GIVEN,
-    default_headers: Mapping[str, str] | None = None,
-    set_default_headers: Mapping[str, str] | None = None,
-    default_query: Mapping[str, object] | None = None,
-    set_default_query: Mapping[str, object] | None = None,
-    _extra_kwargs: Mapping[str, Any] = {}
-) -> Self
-
    
-
-    
    
-
-        
    Create a new client instance re-using the same options given to the current client with optional overriding.
    
-
-    
    
-
-
    
-
-
    
-
-
-
    
-            create_database
+
    
+            delete_database
 
 
-
    
-
    create_database(
+
+
    delete_database(
     *,
-    database: Database,
+    database_id: str,
     extra_headers: Headers | None = None,
     extra_query: Query | None = None,
     extra_body: Body | None = None,
     timeout: float | Timeout | None | NotGiven = NOT_GIVEN
-) -> CreateDatabaseResponse
+) -> DeleteDatabaseResponse
 
    
 
     
    
 
-        
    Create a new database.
    
+        
    Permanently deletes a database.
    
 
 
 
    Parameters:
    
@@ -8543,53 +9997,38 @@ 
    
 
 
-
    
-            create_file_download_url
+
    
+            delete_database_column
 
 
-
    
-
    create_file_download_url(
+
+
    delete_database_column(
     *,
-    file_id: str,
+    column_id: str,
+    database_id: str,
     extra_headers: Headers | None = None,
     extra_query: Query | None = None,
     extra_body: Body | None = None,
     timeout: float | Timeout | None | NotGiven = NOT_GIVEN
-) -> CreateFileDownloadURLResponse
+) -> DeleteDatabaseColumnResponse
 
    
 
     
    
 
-        
    Returns a pre-signed S3 URL.
    
+        
    Delete a column from a database.
    
 
 
 
    Parameters:
    
     
-          
-          
-          
-          
-        
-      
-      
-          
-            
-            
-            
-            
-          
+          
+          
+          
+          
+        
+      
+      
+            
+          
+          
+            
+            
+            
-            
-            
-            
-          
-          
-            
+            
+            
+            
+          
+            
+            
+            
+          
    
       
         
    NameTypeDescriptionDefault
    
-                file_id
-            
-                  str
-            
-              
    
-                
    Deep Origin system ID.
    
-              
    
-                		
-                required
-            
    NameTypeDescriptionDefault
    
           
    
             
                 extra_headers
@@ -8664,28 +10103,26 @@ 
    
 
 
-
    
-            create_file_upload
+
    
+            delete_rows
 
 
-
    
-
    create_file_upload(
+
+
    delete_rows(
     *,
-    content_length: str,
-    name: str,
-    checksum_sha256: str | NotGiven = NOT_GIVEN,
-    content_type: str | NotGiven = NOT_GIVEN,
+    database_id: str,
+    delete_all: bool | NotGiven = NOT_GIVEN,
+    row_ids: List[str] | NotGiven = NOT_GIVEN,
     extra_headers: Headers | None = None,
     extra_query: Query | None = None,
     extra_body: Body | None = None,
     timeout: float | Timeout | None | NotGiven = NOT_GIVEN
-) -> CreateFileUploadResponse
+) -> DeleteRowsResponse
 
    
 
     
    
 
-        
    Create a file upload URL.
    
-
    Typically this is creating a pre-signed S3 URL.
    
+        
    Delete rows by their ids.
    
 
 
 
    Parameters:
    
@@ -8701,14 +10138,31 @@ 
    
             
    		
-                checksum_sha256
+                delete_all
             
             
-                  str | NotGiven
+                  bool | NotGiven
             
             
               
    
-                
    Base64 encoded SHA256 checksum of the file.
    
+                
    When true, deletes all rows in the table except rows with the specified
+  rowIds.
    
+              
    
+                		
+                  NOT_GIVEN
+            
    
+                row_ids
+            
+                  List[str] | NotGiven
+            
+              
    
+                
    List of row IDs to delete.
    
               
    
                 		
             
@@ -8789,24 +10243,24 @@ 
    
 
 
-
    
-            create_workspace
+
    
+            delete_workspace
 
 
-
    
-
    create_workspace(
+
+
    delete_workspace(
     *,
-    workspace: Workspace,
+    workspace_id: str,
     extra_headers: Headers | None = None,
     extra_query: Query | None = None,
     extra_body: Body | None = None,
     timeout: float | Timeout | None | NotGiven = NOT_GIVEN
-) -> CreateWorkspaceResponse
+) -> DeleteWorkspaceResponse
 
    
 
     
    
 
-        
    Create a new workspace.
    
+        
    Permanently deletes a workspace and all its children.
    
 
 
 
    Parameters:
    
@@ -8894,24 +10348,24 @@ 
    
 
 
-
    
-            delete_database
+
    
+            describe_code_execution
 
 
-
    
-
    delete_database(
+
+
    describe_code_execution(
     *,
-    database_id: str,
+    id: str,
     extra_headers: Headers | None = None,
     extra_query: Query | None = None,
     extra_body: Body | None = None,
     timeout: float | Timeout | None | NotGiven = NOT_GIVEN
-) -> DeleteDatabaseResponse
+) -> DescribeCodeExecutionResponse
 
    
 
     
    
 
-        
    Permanently deletes a database.
    
+        
    Returns information about a particular code execution.
    
 
 
 
    Parameters:
    
@@ -8999,25 +10453,24 @@ 
    
 
 
-
    
-            delete_database_column
+
    
+            describe_database
 
 
-
    
-
    delete_database_column(
+
+
    describe_database(
     *,
-    column_id: str,
     database_id: str,
     extra_headers: Headers | None = None,
     extra_query: Query | None = None,
     extra_body: Body | None = None,
     timeout: float | Timeout | None | NotGiven = NOT_GIVEN
-) -> DeleteDatabaseColumnResponse
+) -> DescribeDatabaseResponse
 
    
 
     
    
 
-        
    Delete a column from a database.
    
+        
    Describe a database
    
 
 
 
    Parameters:
    
@@ -9105,26 +10558,28 @@ 
    
 
 
-
    
-            delete_rows
+
    
+            describe_database_row
 
 
-
    
-
    delete_rows(
+
+
    describe_database_row(
     *,
-    database_id: str,
-    delete_all: bool | NotGiven = NOT_GIVEN,
-    row_ids: List[str] | NotGiven = NOT_GIVEN,
+    row_id: str,
+    column_selection: (
+        ColumnSelection | NotGiven
+    ) = NOT_GIVEN,
+    database_id: str | NotGiven = NOT_GIVEN,
     extra_headers: Headers | None = None,
     extra_query: Query | None = None,
     extra_body: Body | None = None,
     timeout: float | Timeout | None | NotGiven = NOT_GIVEN
-) -> DeleteRowsResponse
+) -> DescribeDatabaseRowResponse
 
    
 
     
    
 
-        
    Delete rows by their ids.
    
+        
    Describe a database row
    
 
 
 
    Parameters:
    
@@ -9140,31 +10595,14 @@ 
    
             
    		
-                delete_all
-            
-                  bool | NotGiven
-            
-              
    
-                
    When true, deletes all rows in the table except rows with the specified
-  rowIds.
    
-              
    
-                		
-                  NOT_GIVEN
-            
    
-                row_ids
+                column_selection
             
             
-                  List[str] | NotGiven
+                  ColumnSelection | NotGiven
             
             
               
    
-                
    List of row IDs to delete.
    
+                
    Select columns for inclusion/exclusion.
    
               
    
                 		
             
@@ -9245,24 +10683,24 @@ 
    
 
 
-
    
-            delete_workspace
+
    
+            describe_database_stats
 
 
-
    
-
    delete_workspace(
+
+
    describe_database_stats(
     *,
-    workspace_id: str,
+    database_id: str,
     extra_headers: Headers | None = None,
     extra_query: Query | None = None,
     extra_body: Body | None = None,
     timeout: float | Timeout | None | NotGiven = NOT_GIVEN
-) -> DeleteWorkspaceResponse
+) -> DescribeDatabaseStatsResponse
 
    
 
     
    
 
-        
    Permanently deletes a workspace and all its children.
    
+        
    Returns aggregation information about a particular database.
    
 
 
 
    Parameters:
    
@@ -9350,24 +10788,24 @@ 
    
 
 
-
    
-            describe_code_execution
+
    
+            describe_file
 
 
-
    
-
    describe_code_execution(
+
+
    describe_file(
     *,
-    id: str,
+    file_id: str,
     extra_headers: Headers | None = None,
     extra_query: Query | None = None,
     extra_body: Body | None = None,
     timeout: float | Timeout | None | NotGiven = NOT_GIVEN
-) -> DescribeCodeExecutionResponse
+) -> DescribeFileResponse
 
    
 
     
    
 
-        
    Returns information about a particular code execution.
    
+        
    Describe a file by its ID.
    
 
 
 
    Parameters:
    
@@ -9381,6 +10819,22 @@ 
    
+            
    		
+                file_id
+            
+                  str
+            
+              
    
+                
    Deep Origin system ID.
    
+              
    
+                		
+                required
+            
    
           
    
             
                 extra_headers
@@ -9455,24 +10909,26 @@ 
    
 
 
-
    
-            describe_database
+
    
+            describe_hierarchy
 
 
-
    
-
    describe_database(
+
+
    describe_hierarchy(
     *,
-    database_id: str,
+    id: str,
+    type: Literal["database", "row", "workspace"],
+    database_id: str | NotGiven = NOT_GIVEN,
     extra_headers: Headers | None = None,
     extra_query: Query | None = None,
     extra_body: Body | None = None,
     timeout: float | Timeout | None | NotGiven = NOT_GIVEN
-) -> DescribeDatabaseResponse
+) -> DescribeHierarchyResponse
 
    
 
     
    
 
-        
    Describe a database
    
+        
    Describe the hierarchical position of an entity.
    
 
 
 
    Parameters:
    
@@ -9560,24 +11016,30 @@ 
    
 
 
-
    
-            describe_database_stats
+
    
+            describe_row
 
 
-
    
-
    describe_database_stats(
+
+
    describe_row(
     *,
-    database_id: str,
+    row_id: str,
+    column_selection: (
+        ColumnSelection | NotGiven
+    ) = NOT_GIVEN,
+    fields: bool | NotGiven = NOT_GIVEN,
     extra_headers: Headers | None = None,
     extra_query: Query | None = None,
     extra_body: Body | None = None,
     timeout: float | Timeout | None | NotGiven = NOT_GIVEN
-) -> DescribeDatabaseStatsResponse
+) -> DescribeRowResponse
 
    
 
     
    
 
-        
    Returns aggregation information about a particular database.
    
+        
    Deprecated.
    
+
    Use DescribeDatabaseRow, DescribeDatabase, or DescribeWorkspace
+instead.
    
 
 
 
    Parameters:
    
@@ -9591,6 +11053,22 @@ 
    
+            
    		
+                column_selection
+            
+                  ColumnSelection | NotGiven
+            
+              
    
+                
    Select columns for inclusion/exclusion.
    
+              
    
+                		
+                  NOT_GIVEN
+            
    
           
    
             
                 extra_headers
@@ -9665,53 +11143,37 @@ 
    
 
 
-
    
-            describe_file
+
    
+            describe_workspace
 
 
-
    
-
    describe_file(
+
+
    describe_workspace(
     *,
-    file_id: str,
+    workspace_id: str,
     extra_headers: Headers | None = None,
     extra_query: Query | None = None,
     extra_body: Body | None = None,
     timeout: float | Timeout | None | NotGiven = NOT_GIVEN
-) -> DescribeFileResponse
+) -> DescribeWorkspaceResponse
 
    
 
     
    
-
-        
    Describe a file by its ID.
    
-
-
-
    Parameters:
    
-    
-      
-        
-          
-          
-          
-          
-        
-      
-      
-          
-            
-            
-            
-            
-          
+
+        
    Describe a workspace
    
+
+
+
    Parameters:
    
+    
    NameTypeDescriptionDefault
    
-                file_id
-            
-                  str
-            
-              
    
-                
    Deep Origin system ID.
    
-              
    
-                		
-                required
-            
    
+      
+        
+          
+          
+          
+          
+        
+      
+      
@@ -9913,24 +11369,28 @@ 
    
 
 
-
    
-            describe_workspace
+
    
+            ensure_rows
 
 
-
    
-
    describe_workspace(
+
+
    ensure_rows(
     *,
-    workspace_id: str,
+    database_id: str,
+    rows: Iterable[Row],
+    check_previous_value: bool | NotGiven = NOT_GIVEN,
     extra_headers: Headers | None = None,
     extra_query: Query | None = None,
     extra_body: Body | None = None,
     timeout: float | Timeout | None | NotGiven = NOT_GIVEN
-) -> DescribeWorkspaceResponse
+) -> EnsureRowsResponse
 
    
 
     
    
 
-        
    Describe a workspace
    
+        
    Either creates or updates an existing row.
    
+
    Supports updates to both system and
+user defined columns.
    
 
 
 
    Parameters:
    
@@ -10018,53 +11478,25 @@ 
    
 
 
-
    
-            download_file
-
-
-
    
-
    download_file(
-    *,
-    extra_headers: Headers | None = None,
-    extra_query: Query | None = None,
-    extra_body: Body | None = None,
-    timeout: float | Timeout | None | NotGiven = NOT_GIVEN
-) -> None
-
    
-
-    
    
-
-        
    Returns a 303 redirect to a pre-signed S3 URL.
    
-
-    
    
-
-
    
-
-
    
-
-
-
    
-            ensure_rows
+
    
+            execute_code_async
 
 
-
    
-
    ensure_rows(
+
+
    execute_code_async(
     *,
-    database_id: str,
-    rows: Iterable[Row],
-    check_previous_value: bool | NotGiven = NOT_GIVEN,
+    code: str,
+    code_language: Literal["python"],
     extra_headers: Headers | None = None,
     extra_query: Query | None = None,
     extra_body: Body | None = None,
     timeout: float | Timeout | None | NotGiven = NOT_GIVEN
-) -> EnsureRowsResponse
+) -> ExecuteCodeAsyncResponse
 
    
 
     
    
 
-        
    Either creates or updates an existing row.
    
-
    Supports updates to both system and
-user defined columns.
    
+        
    Execute code asynchronously.
    
 
 
 
    Parameters:
    
@@ -10152,12 +11584,12 @@ 
    
 
 
-
    
-            execute_code_async
+
    
+            execute_code_sync
 
 
-
    
-
    execute_code_async(
+
+
    execute_code_sync(
     *,
     code: str,
     code_language: Literal["python"],
@@ -10165,12 +11597,12 @@ 
    extra_query: Query | None = None,
     extra_body: Body | None = None,
     timeout: float | Timeout | None | NotGiven = NOT_GIVEN
-) -> ExecuteCodeAsyncResponse
+) -> ExecuteCodeSyncResponse
 
    
 
     
    
 
-        
    Execute code asynchronously.
    
+        
    Execute code synchronously.
    
 
 
 
    Parameters:
    
@@ -10258,25 +11690,30 @@ 
    
 
 
-
    
-            execute_code_sync
+
    
+            export_database
 
 
-
    
-
    execute_code_sync(
+
+
    export_database(
     *,
-    code: str,
-    code_language: Literal["python"],
+    database_id: str,
+    format: Literal["csv"],
+    column_selection: (
+        ColumnSelection | NotGiven
+    ) = NOT_GIVEN,
+    filter: Filter | NotGiven = NOT_GIVEN,
+    row_sort: Iterable[RowSort] | NotGiven = NOT_GIVEN,
     extra_headers: Headers | None = None,
     extra_query: Query | None = None,
     extra_body: Body | None = None,
     timeout: float | Timeout | None | NotGiven = NOT_GIVEN
-) -> ExecuteCodeSyncResponse
+) -> BinaryAPIResponse
 
    
 
     
    
 
-        
    Execute code synchronously.
    
+        
    Exports a database to a file.
    
 
 
 
    Parameters:
    
@@ -10290,6 +11727,38 @@ 
    
+            
    
+            
+            
+            
+          
+          
+            
+            
+            
+            
+          
    NameTypeDescriptionDefault
    
           
    
             
                 extra_headers
@@ -9786,30 +11248,24 @@ 
    
 
 
-
    
-            describe_row
+
    
+            download_file
 
 
-
    
-
    describe_row(
+
+
    download_file(
     *,
-    row_id: str,
-    column_selection: (
-        ColumnSelection | NotGiven
-    ) = NOT_GIVEN,
-    fields: bool | NotGiven = NOT_GIVEN,
+    file_id: str,
     extra_headers: Headers | None = None,
     extra_query: Query | None = None,
     extra_body: Body | None = None,
     timeout: float | Timeout | None | NotGiven = NOT_GIVEN
-) -> DescribeRowResponse
+) -> None
 
    
 
     
    
 
-        
    Deprecated.
    
-
    Use DescribeDatabaseRow, DescribeDatabase, or DescribeWorkspace
-instead.
    
+        
    Returns a 303 redirect to a pre-signed S3 URL.
    
 
 
 
    Parameters:
    
@@ -9825,18 +11281,18 @@ 
    
             
    		
-                column_selection
+                file_id
             
             
-                  ColumnSelection | NotGiven
+                  str
             
             
               
    
-                
    Select columns for inclusion/exclusion.
    
+                
    Deep Origin system ID.
    
               
    
                 		
             
-                  NOT_GIVEN
+                required
             
           
    
           
    
+                column_selection
+            
+                  ColumnSelection | NotGiven
+            
+              
    
+                
    Select columns for inclusion/exclusion.
    
+              
    
+                		
+                  NOT_GIVEN
+            
    
+                row_sort
+            
+                  Iterable[RowSort] | NotGiven
+            
+              
    
+                
    Sort rows by column.
    
+              
    
+                		
+                  NOT_GIVEN
+            
    
           
    
             
                 extra_headers
@@ -11490,6 +12959,113 @@ 
    
 
 
+
    
+            resolve_ids
+
+
+
    
+
    resolve_ids(
+    *,
+    database_ids: List[str] | NotGiven = NOT_GIVEN,
+    rows: Iterable[Row] | NotGiven = NOT_GIVEN,
+    workspace_ids: List[str] | NotGiven = NOT_GIVEN,
+    extra_headers: Headers | None = None,
+    extra_query: Query | None = None,
+    extra_body: Body | None = None,
+    timeout: float | Timeout | None | NotGiven = NOT_GIVEN
+) -> ResolveIDsResponse
+
    
+
+    
    
+
+        
    Resolves between system IDs and human IDs (HIDs).
    
+
+
+
    Parameters:
    
+    
+      
+        
+          
+          
+          
+          
+        
+      
+      
+          
+            
+            
+            
+            
+          
+          
+            
+            
+            
+            
+          
+          
+            
+            
+            
+            
+          
+          
+            
+            
+            
+            
+          
+      
+    
    NameTypeDescriptionDefault
    
+                extra_headers
+            
+                  Headers | None
+            
+              
    
+                
    Send extra headers
    
+              
    
+                		
+                  None
+            
    
+                extra_query
+            
+                  Query | None
+            
+              
    
+                
    Add additional query parameters to the request
    
+              
    
+                		
+                  None
+            
    
+                extra_body
+            
+                  Body | None
+            
+              
    
+                
    Add additional JSON properties to the request
    
+              
    
+                		
+                  None
+            
    
+                timeout
+            
+                  float | Timeout | None | NotGiven
+            
+              
    
+                
    Override the client-level default timeout for this request, in seconds
    
+              
    
+                		
+                  NOT_GIVEN
+            
    
+
+    
    
+
+
+
+
    
+
+
 
    
             unlock_database
 
diff --git a/ref/data-hub/types.html b/ref/data-hub/types.html
index fa289c0..37a39b7 100644
--- a/ref/data-hub/types.html
+++ b/ref/data-hub/types.html
@@ -275,6 +275,26 @@
   
   
   
+    
+    
+      
  • 
+        
+          
+  
+    
+  
+  Tools
+
+        
+      
    • 
+    
+  
+
+      
+        
+  
+  
+  
     
  • 
       
         
@@ -1480,6 +1500,242 @@
       
   
   
+  
+  
+    
+    
+      
+        
+          
+        
+      
+        
+      
+        
+      
+    
+    
+      
+      
+        
+      
+    
+    
+    
  • 
+      
+        
+        
+        
+        
+          
+          
+          
    
+            
+              
+  
+  
+    Tools
+  
+  
+
+            
+            
+              
+              
+            
+          
    
+        
+        
+      
+    
    • 
+  
+
+    
+      
+      
+  
+  
   
   
     
  • 
diff --git a/search/search_index.json b/search/search_index.json
index 26d398d..03254b0 100644
--- a/search/search_index.json
+++ b/search/search_index.json
@@ -1 +1 @@
-{"config":{"lang":["en"],"separator":"[\\s\\-]+","pipeline":["stopWordFilter"]},"docs":[{"location":"index.html","title":"Deep Origin CLI and Python client","text":"
       
    •  Access Deep Origin resources Work with your Deep Origin data, variables, secrets, and other resources through a CLI or Python.
      •  
    •  Free and open-source Install onto your computer to use your data, variables, secrets, and other resources outside Deep Origin.
      •  
    •  Easy to install Just run pip install deeporigin.
      •  
    •  Pure Python Lightweight, written in pure Python. Works on any system that can run Python.
      •  
    "},{"location":"index.html#examples","title":"Examples","text":"
    The Deep Origin CLI and Python client allow you to programmatically interact with the Deep Origin OS . The example below illustrates how to use the CLI and Python library to retrieve the database row with ID data-1.
     TerminalPython 
    deeporigin data show data-1\n\n\u256d\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u252c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u256e\n\u2502 Column      \u2502 Value                        \u2502\n\u251c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u253c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2524\n\u2502 Boolean     \u2502 False                        \u2502\n\u2502 Float       \u2502 112                          \u2502\n\u2502 Select      \u2502 sdsd                         \u2502\n\u2502 Date        \u2502 2024-06-19 00:00:00          \u2502\n\u2502 File        \u2502 _file:hnU7F62xeW8j0l1kR7YP1  \u2502\n\u2570\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2534\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u256f\n
     
    from deeporigin.data_hub import api\n\napi.get_row_data(\"data-1\")\n\n# {'Status': 'Processing',\n#  'Age (years)': 15,\n#  'Gender': 'F',\n#  'Order date': '2024-03-01T00:00:00',\n#  'Received by client': '2023-04-05T00:00:00',\n#  'Sent to client': '2024-03-03T00:00:00',\n#  'Sent by client': '2024-03-05T00:00:00',\n#  'Raw reads': ['_file:UjKrB0QibhgBDAVvGQ3VP'],\n#  'Date completed': '2024-03-08T00:00:00',\n# }\n
    "},{"location":"changelog.html","title":"Changelog","text":""},{"location":"changelog.html#deeporigin-v300","title":"deeporigin v3.0.0","text":"
    Breaking changes
     
    This release is a breaking change. Responses to all functions are no longer objects, but are now dictionaries wrapped in python Boxes. 
    "},{"location":"changelog.html#bugfixes","title":"Bugfixes","text":"
       
    • Fixed a bug where writing more than 1000 rows failed
      •  
    • Fixed a bug where constructing a dataframe from an empty DB failed
      •  
    "},{"location":"changelog.html#new-features","title":"New features","text":"
       
    • Ability to add new data to existing dataframes
      •  
    • Support for Deep Origin platform SDK
      •  
    • Deep Origin dataframes now disallow adding rows
      •  
    • Better support for writing data back to databases
      •  
    "},{"location":"changelog.html#miscellaneous","title":"Miscellaneous","text":"
       
    • Initial support for integration tests with Deep Origin Data Hub
      •  
    • Large refactor of testing
      •  
    "},{"location":"changelog.html#deeporigin-v240","title":"deeporigin v2.4.0","text":""},{"location":"changelog.html#bugfixes_1","title":"Bugfixes","text":"
       
    • fixed a bug in how tokens were refreshed
      •  
    • fixed a bug in CLI config use
      •  
    "},{"location":"changelog.html#new-features_1","title":"New features","text":"
       
    • added the ability to download files in parallel
      •  
    • added ability to upload files with file hashes 
      •  
    • added the ability to decode user tokens
      •  
    • support for a async client for the Deep Origin Data Hub API
      •  
    • reference IDs now tracked in dataframes 
      •  
    • dataframes now support expressions and users 
      •  
    • dataframe slicing now restricts addition of new rows to slice
      •  
    • dataframe updates more atomic: a single cell change only triggers updating that cell
      •  
    • ability to delete terminated workstations 
      •  
    • package wide ability to check for latest versions on PyPI
      •  
    "},{"location":"changelog.html#miscellaneous_1","title":"Miscellaneous","text":"
       
    • testing now includes python 3.13
      •  
    • Data Hub API route now set to datahub-api/api/
      •  
    • improved test coverage
      •  
    "},{"location":"changelog.html#deeporigin-v221","title":"deeporigin v2.2.1","text":"
       
    • added the ability to interact with the platform, including
         
      • fetching user secrets from the platform
        •  
      • fetching user info from the platform
        •  
      • fetching workstation info from the platform
        •  
       
      •  
    • removed support for graphQL endpoints for secrets and variables
      •  
    • support for new (breaking) syntax for deleting databases, folders, rows, and columns
      •  
    • better support for caching tokens in filesystem
      •  
    • numerous bug fixes and small improvements
      •  
    • dropped support for Python 3.9
      •  
    • better syntax for interacting with the api.list_files function
      •  
    • Improvements to Deep Origin DataFrames, including:
         
      • ability to create new columns in dataframes and push them to a database
        •  
      • DataFrames now show names of user who created and last updated a database, not just a ID
        •  
      • DataFrame pretty printing methods now never interrupt core logic, and fall back to printing methods of superclass on failure
        •  
      • DataFrames now support df.tail() and df.head()
        •  
       
      •  
    "},{"location":"changelog.html#deeporigin-v211","title":"deeporigin v2.1.1","text":"
       
    • fixed a bug where dataframe header links were sometimes broken
      •  
    • improved display of dataframe headers
      •  
    • improved typing in dataframes
      •  
    • added ability to check for newest versions on PyPI
      •  
    • version numbers are now PEP 440 compliant
      •  
    "},{"location":"changelog.html#deeporigin-v210","title":"deeporigin v2.1.0","text":"
       
    • dropped support for column keys
      •  
    • added the deeporigin.DataFrame class, which:
         
      • is a drop-in replacement for pandas.DataFrame
        •  
      • supports all pandas methods
        •  
      • supports automatic syncing with a Deep Origin database
        •  
       
      •  
    "},{"location":"configure.html","title":"Configuration","text":""},{"location":"configure.html#on-a-deep-origin-workstation","title":"On a Deep Origin workstation","text":"
    On a Deep Origin workstation, no configuration is needed! Within a workstation, the Deep Origin CLI and Python client are automatically configured.
    "},{"location":"configure.html#on-your-local-computer","title":"On your local computer","text":"
    To run this package outside of a Deep Origin workstation (for example, on your own computer), first you need to configure this package. After installing this package, run the following to configure your organization, replacing org-id with the ID of the Deep Origin organization that you would like to work with.
     
    deeporigin config set organization_id [org-id]\n
    "},{"location":"configure.html#view-configuration","title":"View configuration","text":"
    To view the configuration for this package, run:
     
    deeporigin config show\n
     
    This will display a table such as below:
     
    \u256d\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u252c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u256e\n\u2502 Variable                    \u2502 Value                               \u2502\n\u251c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u253c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2524\n\u2502 organization_id             \u2502 likely-aardvark-ewo                 \u2502\n\u2502 bench_id                    \u2502 average-possum-3x3                  \u2502\n\u2502 env                         \u2502 us-west-1                           \u2502\n\u2502 api_endpoint                \u2502 https://os.prod.deeporigin.io/api   \u2502\n\u2502 nucleus_api_route           \u2502 datahub-api/api/                    \u2502\n\u2502 auth_domain                 \u2502 https://formicbio-dev.us.auth0.com  \u2502\n\u2502 auth_device_code_endpoint   \u2502 oauth/device/code/                  \u2502\n\u2502 auth_token_endpoint         \u2502 oauth/token/                        \u2502\n\u2502 auth_audience               \u2502 https://os.deeporigin.io/api        \u2502\n\u2502 auth_grant_type             \u2502 urn:ietf:params:device_code         \u2502\n\u2502 auth_client_id              \u2502 <secret>                            \u2502\n\u2502 auth_client_secret          \u2502 <secret>                            \u2502\n\u2502 variables_cache_filename    \u2502 ~/variables.yml                     \u2502\n\u2502 feature_flags               \u2502                                     \u2502\n\u2570\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2534\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u256f\n
    "},{"location":"configure.html#set-a-configuration-variable","title":"Set a configuration variable","text":"
    To set a variable, run:
     
    deeporigin config set [variable-name] [variable-value]\n
     
    For example, to configure your organization, run:
     
    deeporigin config set organization_id likely-aardvark-ewo\n
    "},{"location":"install.html","title":"Installation","text":""},{"location":"install.html#on-a-deep-origin-workstation","title":"On a Deep Origin workstation","text":"
    No installation needed!
     
    The Deep Origin CLI and Python client are installed on every workstation.
    "},{"location":"install.html#on-your-local-computer","title":"On your local computer","text":"
    Run the command below for your favorite package manager to install the Deep Origin CLI and Python client.
     pippixipipxpipenvpoetryuvmicromambaflit 
    pip install deeporigin\n
     
    pixi add deeporigin\n
     
    pipx install deeporigin\n
     
    pipenv install deeporigin\n
     
    poetry add deeporigin\n
     
    uv pip install deeporigin\n
     
    micromamba install -c https://repo.prefix.dev/deeporigin-public deeporigin\n
     
    flit install deeporigin\n
    "},{"location":"install.html#for-developers","title":"For developers","text":"
    Developers only
     
    If you intend to contribute this package, we recommend installing this package via the instructions below. If you simply intend to use this package, we recommend following the instructions above.
    "},{"location":"install.html#get-the-code","title":"Get the code","text":"
    First, run the following command to clone the source code repository:
     
    git clone git@github.com:deeporiginbio/deeporigin-client.git\n
    "},{"location":"install.html#install-the-development-dependencies-for-this-package","title":"Install the development dependencies for this package","text":"
    Second, install Python 3.9+ and make.
     
    To verify that both are installed, run the following commands:
     
    python3 --version\n# Python 3.12.3\n\nmake --version\n# GNU Make 4.4.1\n
    "},{"location":"install.html#create-an-editable-installation-of-this-package-from-the-cloned-source-code","title":"Create an editable installation of this package from the cloned source code","text":"
    Third, navigate to the directory you cloned the code to, and run the following command:
     
    make install\n
     
    This will install this package in an \"editable\" mode. In this mode, changes to the source code will take effect immediately.
    "},{"location":"install.html#run-the-linting-and-tests-for-this-package","title":"Run the linting and tests for this package","text":"
    Once installed, you can lint and test this package by running the following commands:
     
    make lint\nmake test\n
    "},{"location":"install.html#compiling-and-serving-the-documentation-for-this-package","title":"Compiling and serving the documentation for this package","text":"
    You can compile and serve the documentation for this package by running:
     
    make docs-serve\n
    "},{"location":"install.html#supported-python-versions","title":"Supported Python versions","text":"
    deeporigin is tested against the following versions of Python in Ubuntu Linux and Windows:
     
       
    • 3.10
      •  
    • 3.11
      •  
    • 3.12
      •  
    • 3.13
      •  
    "},{"location":"compute-hub/index.html","title":"Compute hub","text":"
    The Deep Origin compute hub allows you create and use powerful workstations with pre-installed software packages. Deep Origin was built to help computational scientists get clean data from their labs and perform advanced analyses and simulations.
     
    Each Deep Origin workstation comes pre-installed and pre-configured with this Python client and CLI.
     
    Learn more about the compute hub here .
    "},{"location":"data-hub/index.html","title":"Data hub","text":"
    The Deep Origin data hub provides R&D teams a foundation for collaboratively capturing data, extracting insights, and making decisions:
     
       
    • Databases for capturing rows of data, metadata, and procedures.
      •  
    • Customizable columns for capturing structured information such as the age and genotype of a sample.
      •  
    • Notebooks such as for common protocols and recording experiments.
      •  
    • File columns and notebook attachments for capturing files such as the results of experiments.
      •  
    • Reference columns and notebook mentions for capturing relationships, such as the chemical, RNA, antibody, or cell line that an assay characterized.
      •  
    • Folders for hierarchically organizing data, such as by project, team, or experimental modality.
      •  
    • Column and file viewers such as for visualizing the sequence of a plasmid or the structure of a chemical or protein.
      •  
    • Chart studio for interactively analyzing columnar data.
      •  
    • AI assistant for interactively analyze and visualize data.
      •  
    • Process flows and automations for streamlining data processing, decision-making, and project management.
      •  
     
    Learn more about the data hub here .
    "},{"location":"data-hub/dataframes.html","title":"Using Deep Origin DataFrames","text":"
    This page describes how to a Deep Origin DataFrame, which are the primary object you will use to interact with a database on Deep Origin. This page will cover:
     
       
    • fetching data from a Deep Origin database
      •  
    • modifying data locally
      •  
    • writing data back to Deep Origin
      •  
     
    What is a Deep Origin DataFrame?
     
    A Deep Origin DataFrame is a subclass of a pandas.DataFrame that is created from a Deep Origin database, and can easily write data back to it. Because it is a subclass of a pandas DataFrame, all pandas DataFrame methods work on Deep Origin DataFrames. 
    "},{"location":"data-hub/dataframes.html#create-a-dataframe","title":"Create a DataFrame","text":"
    Create a DataFrame using:
     
    from deeporigin.data_hub.dataframe import DataFrame\ndf = DataFrame.from_deeporigin(\"database-id\")\n
     
    In a Jupyter Lab, you should be able to view the DataFrame using:
     
    df\n
     
    which should show you something like this:
     
     
    Information in the DataFrame
     
    In addition to information you would find in the rows and columns of a pandas DataFrame, a Deep Origin DataFrame also contains metadata about the underlying database. In the view above we also see:
     
       
    • The name of the database on Deep Origin.
      •  
    • A link to the database on Deep Origin.
      •  
    • When the database was created.
      •  
    • Information about the last edit made to the database. 
      •  
    "},{"location":"data-hub/dataframes.html#modify-data-in-the-dataframe","title":"Modify data in the DataFrame","text":"
    Because a Deep Origin DataFrame is a subclass of a pandas DataFrame, all pandas DataFrame methods work on Deep Origin DataFrames. In this example, we modify values in one of the columns, or modify a single cell.
     Modify entire columnsModify data in a single cell 
    To modify entire columns, use native pandas syntax:
     
    df[\"y^2\"] = df[\"y\"] ** 2\n
     
    To modify data in a single cell, use native pandas syntax (the at operator):
     
    df.at[\"sgs-1\", \"y\"] = 10\n
     
    In either case, when we view the DataFrame once more using df, we see the updated data, together with a warning telling us that we have local changes that haven't been written back to Deep Origin.
     
    "},{"location":"data-hub/dataframes.html#write-data-back-to-deep-origin","title":"Write data back to Deep Origin","text":"
    Work in progress
     
    Writing data back to Deep Origin from a Deep Origin DataFrame is still a work in progress. The following functionality is not yet supported. To perform these functions, use the API directly instead. 
     
       
    • Updating values of cells that contain files
      •  
    • Updating values of cells that contain references
      •  
    • Uploading files
      •  
    • Modifying or deleting existing columns. To delete a column, use the GUI or the API and then use the from_deeporigin method.
      •  
    • Creating new columns. To insert data into a new column, create a new column using the GUI or the API and then use the from_deeporigin method.
      •  
    • Deleting rows
      •  
    • Creating new databases
      •  
    "},{"location":"data-hub/dataframes.html#using-the-to_deeporigin-method","title":"Using the to_deeporigin method","text":"
    Local changes in the dataframe can be written back to Deep Origin using the to_deeporigin method:
     
    df.to_deeporigin()\n\n# \u2714\ufe0e Wrote 9 rows in y^2 to Deep Origin database.\n
     
    The to_deeporigin method writes data that have been modified in the local dataframe back to the corresponding Deep Origin Database. 
     
    Intelligent writing
     
       
    • Deep Origin DataFrames keep track of local changes, and only write columns back that have been modified locally. 
      •  
    • Every call of to_deeporigin will generate a print statement describing the changes that have been written back to Deep Origin. 
      •  
    • Because a Deep Origin DataFrame corresponds to a database on Deep Origin, there is no need to specify the database name in the to_deeporigin method.
      •  
     
    If we now view the dataframe once more using df, we see the following:
     
     
    Note that the warning about local changes that have not been written back to Deep Origin has disappeared, because the changes have been written back to Deep Origin.
    "},{"location":"data-hub/dataframes.html#automatic-writing-to-deep-origin","title":"Automatic writing to Deep Origin","text":"
    All Deep Origin DataFrames have an attribute called auto_sync that determines if local changes are written automatically to Deep Origin. By default, auto_sync is set to False, requiring you to call the to_deeporigin method to write changes back to Deep Origin.
     
    To enable automatic syncing, set the auto_sync attribute to True:
     
    df.auto_sync = True\ndf\n
     
     
    Note that the dataframe now displays a message indicating that local changes will be written back to Deep Origin.
     
    Making any change to the dataframe now triggers a write back to the Deep Origin database.
     
    df[\"y^2\"] = df[\"y\"] * 0.99\ndf\n\n# \u2714\ufe0e Wrote 9 rows in y^2 to Deep Origin database.\n
     
    Use auto_sync with caution
     
    Turning on auto_sync on dataframes can be dangerous.  - Changes made to the local database are written to a Deep Origin database automatically, and no confirmation is asked for.  - This can cause data loss. - Every change made to the database is written immediately, so modifying the local dataframe multiple times leads to multiple writes to a Deep Origin database.
    "},{"location":"data-hub/dataframes.html#reference","title":"Reference","text":"
    Read more about the to_deeporigin method here. 
    "},{"location":"how-to/auth.html","title":"Sign into Deep Origin","text":"
    Configure if running locally
     
    If you're running this code on your local computer (outside of a Deep Origin Workstation), make sure to configure it first.
     
    To use most of the functionality of the CLI or Python client, you must first run one of the following commands to sign into Deep Origin.
     CLIPython 
    deeporigin authenticate\n
     
    from deeporigin import auth\nauth.authenticate()\n
     
    In either case, you will be presented with a prompt similar to below:
     
    To connect to the Deep Origin OS, navigate your browser to \n\nhttps://<env>auth0.com/activate?user_code=VMPZ-PQFG\n\nand verify the confirmation code is \"VMPZ-PQFG\", and click the \"Confirm\" button.\n
     
    When you visit that URL, you will see a prompt that looks like:
     
     
    After clicking the Confirm button, you will see a confirmation similar to below:
     
     
    After signing in, your access tokens will be cached to disk and then automatically be used in subsequent interactions with Deep Origin.
     
    Authenticating
     
    In most cases, you only need to authenticate to the Deep Origin OS once. You do not need to authenticate every time you use the client or the CLI.
     
    Authenticating on Deep Origin workstations
     
    Presently, workstation users must authenticate (once) to the Deep Origin OS. We plan to develop the capability to automatically authenticate workstation users.
    "},{"location":"how-to/compute-hub/variables.html","title":"Install variables and secrets","text":"
    Variables and secrets captured in the Deep Orgin OS, either at the organization level or the account level, can be installed into workstations by running the following command:
     
    deeporigin variables install\n
     
    This command will install your variables and secrets into your workstation and print a message similar to that below:
     
    No variables were modified\nNo variables were added\nNo variables were deleted\n1 variables were unmodified:\n  EnvironmentVariable: foo\n
     
    Only on Deep Origin workstations
     
    This function of the CLI only works on Deep Origin workstations. This function will not work on your local computer.
    "},{"location":"how-to/compute-hub/workstation-info.html","title":"Get information about your Deep Origin workstation","text":"
    Inside a Deep Origin workstation, run the following command to get information about the workstation:
     
    deeporigin context\n
     
    This will display a table similar to below:
     
    Workstation ID: average-possum-3x3\nUser ID: None\nOrganization ID: likely-aardvark-ewo\nEnvironment: edge\nDebug: False\n
     
    Only supported on Deep Origin workstations
     
    Note that this command is only supported on Deep Origin workstations. If you run this command outside of a workstation, you will likely see this output:
     
    Workstation ID: None\nUser ID: None\nOrganization ID: None\nEnvironment: None\nDebug: False\n
    "},{"location":"how-to/data-hub/add-data.html","title":"Add data to a Deep Origin Database","text":"
    This document describes how to add data to a Deep Origin Database.
     
    Consider the following dataframe constructed from a database using:
     
    from deeporigin.data_hub import api\ndf = api.get_dataframe(\"xy\")\ndf\n
     
    "},{"location":"how-to/data-hub/add-data.html#add-new-rows","title":"Add new rows","text":"
    To add new rows to the underlying database, use the add_databse_rows function:
     
    data = dict(X=[1, 2], Y=[2, 3])\napi.add_database_rows(database_id=\"xy\", data=data)\n
     
    data should be a dictionary where the keys are column names and the values are lists of values to be written to the corresponding columns. add_database_rows will add this data to the database, creating as many new rows as needed. 
     
    add_database_rows returns a list of the row IDs created during this process.
    "},{"location":"how-to/data-hub/add-data.html#add-fragments-of-new-rows","title":"Add fragments of new rows","text":"
    Similarly, fragments of rows (subsets of columns) can be written to the database:
     
    data = dict(X=[10, 20]) # note Y is not specified\napi.add_database_rows(database_id=\"xy\", data=data)\n
     
    add_database_rows returns a list of the row IDs created during this process, for example:
     
    [\"row-1\", \"row-2\"]\n
    "},{"location":"how-to/data-hub/add-data.html#reference","title":"Reference","text":"
    The reference documentation for add_database_rows
    "},{"location":"how-to/data-hub/create.html","title":"Create objects","text":"
    This document describes how to create databases, columns in databases, and folders (workspaces) in the Deep Origin data hub.
    "},{"location":"how-to/data-hub/create.html#folders","title":"Folders","text":"
    Folders can be created by specifying a name, and, optionally, a parent.
     CLIPython 
    If no parent is specified, the folder will be created at the root level.
     
    deeporigin data new folder --name <name>  \n
     
    To create a folder within another folder, specify the parent:
     
    deeporigin data new folder \\\n    --name <name> \\ \n    --parent <parent-id>\n
     
    from deeporigin.data_hub import api\napi.create_workspace(name=\"test-folder\")\n
     
    To create a folder within another folder, specify the parent:
     
    api.create_workspace(\n    name=\"test-folder-2\",\n    parent_id=\"parent-id\",\n)\n
    "},{"location":"how-to/data-hub/create.html#databases","title":"Databases","text":"
    Databases can be created by specifying a name, and, optionally, a parent.
     CLIPython 
    If no parent is specified, the database will be created at the root level.
     
    deeporigin data new --name <name>  --database\n
     
    To create a folder within another folder, specify the parent:
     
    deeporigin data new database \\\n    --name <name> \\\n    --parent <parent-id>\n
     
    from deeporigin.data_hub import api\napi.create_database(name=\"test-database\")\n
     
    To create a folder within another folder, specify the parent:
     
    api.create_database(\n    name=\"test-database-2\",\n    parent_id=\"parent-id\",\n)\n
    "},{"location":"how-to/data-hub/create.html#database-columns","title":"Database columns","text":"
    Work in progress
     
    Currently, this package has limited support for creating database columns. We plan to expand the capabilities of this package.
     
    To create a new database column in an existing database, run:
     CLIPython 
    deeporigin data new column \\\n    --name <name> \\\n    --database <database-id> \\\n    --type <type>\n
     
    from deeporigin.data_hub import api\napi.add_database_column(\n    database_id=\"existing-database-id\",\n    type=\"integer\",\n    name=\"unique-name\",\n)\n
     
    This code creates a new column in the existing database. To configure the type of the column, use the type argument. The type must a member of DataType.
    "},{"location":"how-to/data-hub/delete.html","title":"Delete objects","text":"
    This document describes how to delete objects in the Deep Origin data hub:
     
       
    • Database rows
      •  
    • Database columns
      •  
    • Databases
      •  
    • Folders (workspaces)
      •  
     
    Exercise caution
     
       
    • Deleting a folder deletes all of the databases in the folder.
      •  
    • Deleting a column destroys all of the data in that column, including all of the files assigned to the cells in that column.
      •  
    • Deleting a database deletes all of the rows in the database.
      •  
     
    All resources will be deleted without asking for confirmation. 
    "},{"location":"how-to/data-hub/delete.html#delete-database-rows","title":"Delete database rows","text":"
    To delete a row in a database, run:
     CLIPython 
    deeporigin data delete \\\n    --row <row-id> \\\n    --database <database-id>\n
     
    from deeporigin.data_hub import api\napi.delete_rows(row_ids=[\"row-1\", \"row-2\"], database_id=\"database-id\")\n
     
    Deleting multiple rows
     
    Note that the python client allows you to delete multiple rows at once.
    "},{"location":"how-to/data-hub/delete.html#delete-databases","title":"Delete databases","text":"
    To delete an entire database, run:
     CLIPython 
    deeporigin data delete --database <db-id>\n
     
    Aliases
     
    The following alias also works: deeporigin data delete -d <db-id>.
     
    from deeporigin.data_hub import api\napi.delete_database(database_id=<db-id>)\n
    "},{"location":"how-to/data-hub/delete.html#delete-folders-workspaces","title":"Delete folders (workspaces)","text":"
    To delete an entire folder, including all contained databases, run:
     CLIPython 
    deeporigin data delete --folder <id>\n
     
    Aliases
     
    The following aliases also work --workspace, -w, --ws, -f instead of --folder.
     
    from deeporigin.data_hub import api\napi.delete_workspace(workspace_id=<folder-id>)\n
    "},{"location":"how-to/data-hub/delete.html#delete-database-column","title":"Delete database column","text":"
    To delete a column in a databas, run the following command, specifying the ID of the column to delete and its parent database:
     CLIPython 
    deeporigin data delete \\\n    --column <ids> \\\n    --database <database-id> \\\n
     
    from deeporigin.data_hub import api\napi.delete_database_column(\n    column_id=\"col-id\",\n    database_id=\"database-id\",\n)\n
    "},{"location":"how-to/data-hub/download-files.html","title":"Download files","text":"
    This page describes how to download files from Deep Origin to your local computer. 
    "},{"location":"how-to/data-hub/download-files.html#download-one-or-many-files-from-the-data-hub","title":"Download one or many files from the Data hub","text":"
    To download file(s) to the Deep Origin data hub, run the following commands:
     CLIPython 
    deeporigin data download-files\n
     
    This will download all files on Deep Origin to the current folder. 
     
    To download files that have been assigned to a particular row, use:
     
    deeporigin data download-files --assigned-row-ids <row-id-1>  <row-id-2> ...\n
     
    To download specific files, pass the file IDs using:
     
    deeporigin data download-files --file-ids <file-1> <file-1> ...\n
     
    from deeporigin.data_hub import api\napi.download_files(files)\n
     
    files is a list of files to download, and is a list of ListFilesResponse objects. To obtain this list, use api.list_files(), the output of which can be used as an input to download_files. 
     
    Download all files
     
    To download all files, call api.list_files() and pass the output to download_files.
    "},{"location":"how-to/data-hub/list-data.html","title":"List data","text":"
    This page describes how to list resources on Deep Origin. Listing folders (workspaces), databases, rows and files can be used to discover the resources available on Deep Origin, and show their IDs for further queries.
    "},{"location":"how-to/data-hub/list-data.html#list-folders","title":"List folders","text":"
    To list all of your Deep Origin folders, run:
     CLIPython 
    deeporigin data list --folders\n
     
    This will display a screen similar to below:
     
    \u256d\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u252c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u252c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u256e\n\u2502 Name            \u2502 Type       \u2502 ID            \u2502\n\u251c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u253c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u253c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2524\n\u2502 Secret Project  \u2502 workspace  \u2502 secret        \u2502\n\u2502 QC Efforts      \u2502 workspace  \u2502 qc-efforts    \u2502\n\u2502 Covid Target    \u2502 workspace  \u2502 corona        \u2502\n\u2570\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2534\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2534\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u256f\n
     JSON output with --json 
    JSON output can be requested by adding --json, and allows you to pipe out to a JSON processor like jq:
     
    deeporigin data list --folders --json | jq\n
     
    [\n  {\n    \"id\": \"_workspace:ncZhbnYXXfg0zWNcGKTnz\",\n    \"parentId\": null,\n    \"hid\": \"secret\",\n    \"type\": \"workspace\",\n    \"name\": \"Secret Project\"\n  },\n  {\n    \"id\": \"_workspace:sDTZKGZXOkhGw6XSg2Jla\",\n    \"parentId\": null,\n    \"hid\": \"qc-efforts\",\n    \"type\": \"workspace\",\n    \"name\": \"QC Efforts\"\n  },\n  {\n    \"id\": \"_workspace:UWhlb4Wyzh2R7bySapY2m\",\n    \"parentId\": null,\n    \"hid\": \"corona\",\n    \"type\": \"workspace\",\n    \"name\": \"Covid Target\"\n  }\n]\n
     Combining outputs 
    You can combine multiple output types. For example, to list all folders and databases:
     
    deeporigin data list --folders --databases\n
     
    from deeporigin.data_hub import api\napi.list_rows(row_type=\"workspace\")\n
    "},{"location":"how-to/data-hub/list-data.html#list-databases","title":"List databases","text":"
    To list all of your databases in Deep Origin, run:
     CLIPython 
    deeporigin data list --databases\n
     
    This will display a screen similar to below:
     
    \u256d\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u252c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u252c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u256e\n\u2502 Name           \u2502 Type      \u2502 ID             \u2502\n\u251c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u253c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u253c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2524\n\u2502 First Database \u2502 database  \u2502 first          \u2502\n\u2502 QC Efforts     \u2502 database  \u2502 qc-efforts     \u2502\n\u2502 Covid Target   \u2502 database  \u2502 corona         \u2502\n\u2570\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2534\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2534\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u256f\n
     JSON output with --json 
    JSON output can be requested by adding --json, and allows you to pipe out to a JSON processor like jq:
     
    deeporigin data list --databases --json | jq\n
     
    [\n  {\n    \"id\": \"_database:ncZhbnYXXfg0zWNcGKTnz\",\n    \"parentId\": \"_workspace:ncZhbnYXXfg0zWNcGKTnz\",\n    \"hid\": \"db-first\",\n    \"type\": \"database\",\n    \"name\": \"First Database\"\n  },\n  {\n    \"id\": \"_database:sDTZKGZXOkhGw6XSg2Jla\",\n    \"parentId\": \"_workspace:sDTZKGZXOkhGw6XSg2Jla\",\n    \"hid\": \"db-qc\",\n    \"type\": \"database\",\n    \"name\": \"QC Efforts\"\n  },\n  {\n    \"id\": \"_database:UWhlb4Wyzh2R7bySapY2m\",\n    \"parentId\": \"_workspace:UWhlb4Wyzh2R7bySapY2m\",\n    \"hid\": \"db-covid\",\n    \"type\": \"database\",\n    \"name\": \"Covid Target\"\n  }\n]\n
     Combining outputs 
    You can combine multiple output types. For example, to list all folders and databases:
     
    deeporigin data list --folders --databases\n
     
    from deeporigin.data_hub import api\napi.list_rows(row_type=\"database\")\n
    "},{"location":"how-to/data-hub/list-data.html#list-rows","title":"List rows","text":"
    To list all of your database rows in Deep Origin:
     CLIPython 
    deeporigin data list --rows\n
     
    This will display a screen similar to below:
     
    \u256d\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u252c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u252c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u256e\n\u2502 Name   \u2502 Type   \u2502 ID     \u2502\n\u251c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u253c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u253c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2524\n\u2502        \u2502 row    \u2502 data-1 \u2502\n\u2502        \u2502 row    \u2502 data-2 \u2502\n\u2502        \u2502 row    \u2502 data-3 \u2502\n\u2502        \u2502 row    \u2502 data-4 \u2502\n\u2502        \u2502 row    \u2502 data-5 \u2502\n\u2570\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2534\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2534\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u256f\n
     
    from deeporigin.data_hub import api\napi.list_rows(row_type=\"row\")\n
    "},{"location":"how-to/data-hub/list-data.html#list-files","title":"List files","text":"
    To list all of your files in Deep Origin, run:
     CLIPython 
    deeporigin data list --files\n
     
    This will display a screen similar to below:
     
    \u256d\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u252c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u252c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u256e\n\u2502 Name       \u2502 Status   \u2502 ID                          \u2502\n\u251c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u253c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u253c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2524\n\u2502 db-dna.csv \u2502 ready    \u2502 _file:gBAK9tzFC5Cegx4NmSETc \u2502\n\u2502 seqs.gz    \u2502 ready    \u2502 _file:FgVjcv8zzyPho6FME8QFp \u2502\n\u2502 db-rna.csv \u2502 ready    \u2502 _file:hnU7F62xeW8j0l1kR7YP1 \u2502\n\u2570\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2534\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2534\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u256f\n
     JSON output with --json 
    JSON output can be requested by adding --json, and allows you to pipe out to a JSON processor like jq:
     
    deeporigin data list --databases --json | jq\n
     
    [\n  {\n    \"file\": {\n      \"id\": \"_file:gBAK9tzFC5Cegx4NmSETc\",\n      \"uri\": \"s3://_file:gBAK9tzFC5Cegx4NmSETc\",\n      \"name\": \"db-dna.csv\",\n      \"status\": \"ready\",\n      \"contentLength\": 234,\n      \"contentType\": \"text/csv\",\n      \"dateCreated\": \"2024-05-08 01:01:48.925\",\n      \"dateUpdated\": \"2024-05-08 01:01:48.925\",\n      \"createdByUserDrn\": \"scientist@deeporigin.com\"\n    }\n  },\n  {\n    \"file\": {\n      \"id\": \"_file:FgVjcv8zzyPho6FME8QFp\",\n      \"uri\": \"s3://_file:FgVjcv8zzyPho6FME8QFp\",\n      \"name\": \"seqs.gz\",\n      \"status\": \"ready\",\n      \"contentLength\": 554588,\n      \"contentType\": \"zip/gz\",\n      \"dateCreated\": \"2024-05-08 18:08:09.149\",\n      \"dateUpdated\": \"2024-05-08 18:08:09.149\",\n      \"createdByUserDrn\": \"scientist@deeporigin.com\"\n    },\n    \"assignments\": [\n      {\n        \"rowId\": \"_row:WORR9xeGvG6mSg0yyDRlk\"\n      }\n    ]\n  },\n  {\n    \"file\": {\n      \"id\": \"_file:hnU7F62xeW8j0l1kR7YP1\",\n      \"uri\": \"s3://_file:hnU7F62xeW8j0l1kR7YP1\",\n      \"name\": \"db-rna.csv\",\n      \"status\": \"ready\",\n      \"contentLength\": 234,\n      \"contentType\": \"text/csv\",\n      \"dateCreated\": \"2024-05-08 18:07:57.655\",\n      \"dateUpdated\": \"2024-05-08 18:07:57.655\",\n      \"createdByUserDrn\": \"scientist@deeporigin.com\"\n    },\n    \"assignments\": [\n      {\n        \"rowId\": \"_row:mlNnmNkfktz7GT5qpjyrF\"\n      }\n    ]\n  }\n]\n
     
    Listing files cannot list other objects
     
    If you pass --files to the list command, all other  arguments are ignored. As a result, 
     
    deeporigin data list --files --databases\n
     will only list files.
     
    First, we start off by importing the necessary modules:
     
    We can list all files on Deep Origin using:
     
    from deeporigin.data_hub import api\napi.list_files()\n
     
    To find only unassigned files, we can use:
     
    api.list_files(is_unassigned=True)\n
     
    To find files that are assigned to a specific row:
     
    api.list_files(assigned_row_ids=[\"row-1\"])\n
    "},{"location":"how-to/data-hub/upload-files.html","title":"Upload files","text":"
    This page describes how to upload files to the Deep Origin data hub, and assign them to individual cells.
    "},{"location":"how-to/data-hub/upload-files.html#upload-a-file-to-the-data-hub","title":"Upload a file to the data hub","text":"
    To upload a file to the Deep Origin data hub, run the following commands:
     CLIPython 
    deeporigin data upload /path/to/test.fasta\n
     
    This will upload the file to your data hub, but the file will not yet be assigned to any database or cell. An example response is shown below:
     
    \u256d\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u252c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u256e\n\u2502 Property         \u2502 Value                        \u2502\n\u251c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u253c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2524\n\u2502 name             \u2502 test.fasta                   \u2502\n\u2502 contentType      \u2502 data/fasta                   \u2502\n\u2502 contentLength    \u2502 554588                       \u2502\n\u2502 id               \u2502 _file:36ufKT2Sej22coSEOizpK  \u2502\n\u2502 status           \u2502 ready                        \u2502\n\u2502 uri              \u2502 s3://foo                     \u2502\n\u2502 dateCreated      \u2502 2024-06-18T14:48:33.501Z     \u2502\n\u2502 dateUpdated      \u2502 2024-06-18T14:48:33.501Z     \u2502\n\u2502 createdByUserDrn \u2502 levins@deeporigin.com        \u2502\n\u2570\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2534\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u256f\n
     JSON output with --json 
    JSON output can be requested by adding --json, and allows you to pipe out to a JSON processor like jq:
     
    deeporigin upload /path/to/test.fasta | jq\n
     
    {\n  \"name\": \"test.fasta\",\n  \"contentType\": \"data/fasta\",\n  \"contentLength\": 554588,\n  \"id\": \"_file:36ufKT2Sej22coSEOizpK\",\n  \"status\": \"ready\",\n  \"uri\": \"s3://foo\",\n  \"dateCreated\": \"2024-06-18T14:51:43.876Z\",\n  \"dateUpdated\": \"2024-06-18T14:51:43.876Z\",\n  \"createdByUserDrn\": \"levins@deeporigin.com\"\n}\n
     
    from deeporigin.data_hub import api\napi.upload_file(\"/path/to/file.fasta\")\n
     
    This will upload the file to your data hub. An example is shown below:
     
    {\n    \"name\": \"file.fasta\",\n    \"contentType\": \"data/foo\",\n    \"contentLength\": 55454688,\n    \"id\": \"_file:6Hdhyc3t8xZ6pmyCrQy1t\",\n    \"status\": \"ready\",\n    \"uri\": \"s3://data.<org-name>/_file:6Hdhyc3t8xZ6pmyCrQy1t\",\n    \"dateCreated\": \"2024-06-18T14:18:37.409Z\",\n    \"dateUpdated\": \"2024-06-18T14:18:37.409Z\",\n    \"createdByUserDrn\": \"haldane@deeporigin.com\",\n}\n
    "},{"location":"how-to/data-hub/upload-files.html#upload-a-file-to-an-existing-row","title":"Upload a file to an existing row","text":"
    To upload a file and assign it to a cell in an existing row, run the following commands:
     CLIPython 
    deeporigin data upload /path/to/test.fasta \\\n    --column <column_id> \\\n    --database <database_id> \\\n    --row <row_id>\n
     
    from deeporigin.data_hub import api\napi.upload_file(\"/path/to/file.fasta\")\n
     
    To assign an uploaded file to a cell in an existing row, run the assign_files_to_cell function:
     
        api.assign_files_to_cell(\n    file_ids=[\"_file:6Hdhyc3t8xZ6pmyCrQy1t\"],\n    database_id=\"db-dna\",\n    column_id=\"base_sequence_file\",\n    row_id=\"row-id\",\n)\n
    "},{"location":"how-to/data-hub/upload-files.html#upload-a-file-to-a-new-row-of-a-database","title":"Upload a file to a new row of a database","text":"
    To upload a file and assign it to a column in a new row, run the following commands:
     CLIPython 
    deeporigin data upload /path/to/test.fasta \\\n    --column <column_id> \\\n    --database <database_id> \n
     
    This omits the --row parameter, which would create a new row in the database.
     
    First, upload a file to your data hub by running:
     
    from deeporigin.data_hub import api\napi.upload_file(\"/path/to/file.fasta\")\n
     
    Second, assign the file to a new row by running:
     
    api.assign_files_to_cell(\n    file_ids=[\"_file:6Hdhyc3t8xZ6pmyCrQy1t\"],\n    database_id=\"db-dna\",\n    column_id=\"base_sequence_file\",\n)\n
    "},{"location":"how-to/data-hub/view-data.html","title":"View data","text":"
    This page describes how to describe and show the details of data objects in Deep Origin. To simply list objects, see List data.
    "},{"location":"how-to/data-hub/view-data.html#describe-data","title":"Describe data","text":""},{"location":"how-to/data-hub/view-data.html#describe-rows","title":"Describe rows","text":"
    Describing rows provides metadata about the row, such as its ID, parent, and status.
     
    Describe vs. Show
     
    This does not show you information in that row. To see data contained in that row, use the show command.
     
    To describe a row in a database in Deep Origin, run:
     CLIPython 
    deeporigin data describe <row-id>\n
     
    This will display a table similar to:
     
    \u256d\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u252c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u256e\n\u2502 Column           \u2502 Value                              \u2502\n\u251c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u253c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2524\n\u2502 id               \u2502 _row:WORR9xeGvG6mSg0yyDRlk         \u2502\n\u2502 parentId         \u2502 _database:kyEws11L4KagGAaqRwONv    \u2502\n\u2502 type             \u2502 row                                \u2502\n\u2502 dateCreated      \u2502 2024-05-08 17:59:32.512306         \u2502\n\u2502 dateUpdated      \u2502 2024-05-08 18:08:13.103            \u2502\n\u2502 createdByUserDrn \u2502 scientist@deeporigin.com           \u2502\n\u2502 editedByUserDrn  \u2502 scientist@deeporigin.com           \u2502\n\u2502 hid              \u2502 data-2                             \u2502\n\u2502 validationStatus \u2502 valid                              \u2502\n\u2570\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2534\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u256f\n
     JSON output with --json 
    JSON output can be requested by adding --json, and allows you to pipe out to a JSON processor like jq:
     
    deeporigin data describe <row-id> --json | jq\n
     
    {\n  \"id\": \"_row:WORR9xeGvG6mSg0yyDRlk\",\n  \"parentId\": \"_database:kyEws11L4KagGAaqRwONv\",\n  \"type\": \"row\",\n  \"dateCreated\": \"2024-05-08 17:59:32.512306\",\n  \"dateUpdated\": \"2024-05-08 18:08:13.103\",\n  \"createdByUserDrn\": \"scientist@deeporigin.com\",\n  \"editedByUserDrn\": \"scientist@deeporigin.com\",\n  \"hid\": \"data-2\",\n  \"validationStatus\": \"valid\"\n}\n
     
    from deeporigin.data_hub import api\napi.describe_row(\"_row:WORR9xeGvG6mSg0yyDRlk\")\n
    "},{"location":"how-to/data-hub/view-data.html#describe-files","title":"Describe files","text":"
    To describe a file in a database in Deep Origin, run:
     CLIPython 
    deeporigin data describe <file-id>\n
     
    This will display a table similar to:
     
    \u256d\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u252c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u256e\n\u2502 Property         \u2502 Value                             \u2502\n\u251c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u253c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2524\n\u2502 id               \u2502 _file:gBAK9tzFC5Cegx4NmSETc       \u2502\n\u2502 uri              \u2502 s3://_file:gBAK9tzFC5Cegx4NmSETc  \u2502\n\u2502 name             \u2502 db-dna.csv                        \u2502\n\u2502 status           \u2502 ready                             \u2502\n\u2502 contentLength    \u2502 234                               \u2502\n\u2502 contentType      \u2502 text/csv                          \u2502\n\u2502 dateCreated      \u2502 2024-05-08 01:01:48.925           \u2502\n\u2502 dateUpdated      \u2502 2024-05-08 01:01:48.925           \u2502\n\u2502 createdByUserDrn \u2502 scientist@deeporigin.com          \u2502\n\u2570\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2534\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u256f\n
     JSON output with --json 
    JSON output can be requested by adding --json, and allows you to pipe out to a JSON processor like jq:
     
    deeporigin data describe <file-id> --json | jq\n
     
    {\n  \"id\": \"_file:gBAK9tzFC5Cegx4NmSETc\",\n  \"uri\": \"s3://_file:gBAK9tzFC5Cegx4NmSETc\",\n  \"name\": \"db-dna.csv\",\n  \"status\": \"ready\",\n  \"contentLength\": 234,\n  \"contentType\": \"text/csv\",\n  \"dateCreated\": \"2024-05-08 01:01:48.925\",\n  \"dateUpdated\": \"2024-05-08 01:01:48.925\",\n  \"createdByUserDrn\": \"scientist@deeporigin.com\"\n}\n
     
    from deeporigin.data_hub import api\napi.describe_file(\"file-id\")\n
    "},{"location":"how-to/data-hub/view-data.html#show-data","title":"Show data","text":""},{"location":"how-to/data-hub/view-data.html#show-rows","title":"Show rows","text":"
    To show the data in a row in a database in Deep Origin, run:
     CLIPython 
    deeporigin data show <row-id>\n
     
    This will display a table similar to:
     
    \u256d\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u252c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u256e\n\u2502 Column    \u2502 Value                       \u2502\n\u251c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u253c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2524\n\u2502 File      \u2502 _file:hnU7F62xeW8j0l1kR7YP1 \u2502\n\u2502 Float Num \u2502 112                         \u2502\n\u2502 selctcol  \u2502 sdsd                        \u2502\n\u2570\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2534\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u256f\n
     JSON output with --json 
    JSON output can be requested by adding --json, and allows you to pipe out to a JSON processor like jq:
     
    deeporigin data describe <file-id> --json | jq\n
     
    {\n  \"File\": \"_file:hnU7F62xeW8j0l1kR7YP1\",\n  \"Float Num\": 112,\n  \"selctcol\": \"sdsd\"\n}\n
     
    from deeporigin.data_hub import  api\napi.get_row_data(\"row-id\")\n
     
    The data will be returned as a dictionary, where the keys are the column names and the values are values of the cells.
    "},{"location":"how-to/data-hub/view-data.html#show-databases","title":"Show databases","text":"CLIPython 
    deeporigin data show <database-id>\n
     
    This will display a table similar to:
     
    \u256d\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u252c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u252c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u252c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u252c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u256e\n\u2502  Status   \u2502 stag-id   \u2502 Customer Name    \u2502 Status     \u2502  Output Files     \u2502\n\u251c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u253c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u253c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u253c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u253c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2524\n\u2502 valid     \u2502 stag-1    \u2502 Blue Sun Corp    \u2502 Processing \u2502                   \u2502\n\u2502 valid     \u2502 stag-2    \u2502 Veridian Dynamics\u2502 Complete   \u2502   report.tar.gz   \u2502\n\u2570\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2534\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2534\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2534\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2534\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u256f\n
     JSON output with --json 
    JSON output can be requested by adding --json, and allows you to pipe out to a JSON processor like jq:
     
    deeporigin data describe <database-id> --json | jq\n
     
    {\n  \"Status\": [\n    \"valid\",\n    \"valid\"\n  ],\n  \"stag-id\": [\n    \"stag-1\",\n    \"stag-2\"\n  ],\n  \"Customer Name\": [\n    \"Blue Sun Corp \",\n    \"Veridian Dynamics\"\n  ],\n  \"Status\": [\n    \"Processing\",\n    \"Complete\"\n  ],\n  \"Output Files\": [\n    null,\n    \"report.tar.gz\"\n  ]\n}\n
     
    from deeporigin.data_hub import api\napi.get_dataframe(\"database-id\")\n
     
    The data will be returned as a Pandas DataFrame.
    "},{"location":"how-to/data-hub/write-data.html","title":"Write data","text":"
    This page describes how to write data to the Deep Origin data hub.
    "},{"location":"how-to/data-hub/write-data.html#write-data-to-a-cell-in-a-database","title":"Write data to a cell in a database","text":""},{"location":"how-to/data-hub/write-data.html#write-text-data","title":"Write text data","text":"
    Run the following to write a text value to a cell in a database:
     CLIPython 
    deeporigin data write \"some-string\" \\\n    --database $database_id \\\n    --column $column_id \\\n    --row $row_id\n
     
    from deeporigin.data_hub import api\napi.set_cell_data(\n    \"some string\",\n    database_id=\"database ID or name\",\n    column_id=\"column ID or programmatic key\",\n    row_id=\"row ID\",\n)\n
    "},{"location":"how-to/data-hub/write-data.html#write-numeric-data","title":"Write numeric data","text":"
    Run the following to write a numeric value to a cell in a database:
     CLIPython 
    deeporigin data write 123 \\\n    --database $database_id \\\n    --column $column_id \\\n    --row $row_id\n
     
    from deeporigin.data_hub import api\napi.set_cell_data(\n    1,\n    database_id=\"database ID or name\",\n    column_id=\"column ID or programmatic key\",\n    row_id=\"row ID\",\n)\n
     
    Numeric data will be coerced to the data type of the underlying cell.
    "},{"location":"how-to/data-hub/write-data.html#write-select-data","title":"Write select data","text":"
    This section describes how to write data to a cell in a database that is of type select. This includes cells where a single option can be selected from a list, and cells where more than one value can be selected from a list of options.
     CLIPython 
    deeporigin data write \"option A\" \\\n    --database $database_id \\\n    --column $column_id \\\n    --row $row_id\n
     
    from deeporigin.data_hub import api\napi.set_cell_data(\n    \"option A\",\n    database_id=\"database ID or name\",\n    column_id=\"column ID or programmatic key\",\n    row_id=\"row ID\",\n)\n
     
    The value must be one of the options in the list. If it is not, an error will be raised showing the list of legal options.
    "},{"location":"how-to/data-hub/write-data.html#write-boolean-data","title":"Write Boolean data","text":"
    Run the following to write a Boolean value to a cell in a database:
     CLIPython 
    deeporigin data write \"True\" \\\n    --database $database_id \\\n    --column $column_id \\\n    --row $row_id\n
     
    from deeporigin.data_hub import api\napi.set_cell_data(\n    True,\n    database_id=\"database ID or name\",\n    column_id=\"column ID or programmatic key\",\n    row_id=\"row ID\",\n)\n
     Unsetting Boolean data 
    To unset a cell, so that it contains no data, write None to the cell as follows: 
     
    from deeporigin.data_hub import api\napi.set_cell_data(\n    None,\n    database_id=\"database ID or name\",\n    column_id=\"column ID or programmatic key\",\n    row_id=\"row ID\",\n)\n
    "},{"location":"how-to/platform/user-info.html","title":"Get user information","text":""},{"location":"how-to/platform/user-info.html#get-info-about-current-user","title":"Get info about current user","text":"
    To get information about the currently logged in user, including the user ID, use:
     
    from deeporigin.platform import api\napi.whoami()\n
     
    returns information about the current user. A typical response is:
     
    {\n    \"data\": {\n        \"attributes\": {\n            \"company\": null,\n            \"expertise\": null,\n            \"industries\": null,\n            \"pendingInvites\": [],\n            \"platform\": \"OS\",\n            \"title\": null\n        },\n        \"id\": \"google-apps|user@deeporigin.com\",\n        \"type\": \"User\"\n    },\n    \"links\": {\n        \"self\": \"https://os.deeporigin.io/users/me\"\n    }\n}\n
    "},{"location":"how-to/platform/user-info.html#get-information-about-a-user","title":"Get information about a user","text":"
    To get information about a user, use:
     
    from deeporigin.platform import api\napi.resolve_user(\"user-id\")\n
     
    where user-id is the ID of the user, in the format returned by api.whoami(). A typical response looks like:
     
    {\n    \"data\": {\n        \"attributes\": {\n            \"avatar\": \"https://...\",\n            \"email\": \"user@deeporigin.com\",\n            \"name\": \"User Name\"\n        },\n        \"id\": \"918ddd25-ab97-4400-9a14-7a8be1216754\",\n        \"type\": \"User\"\n    },\n    \"links\": {\n        \"self\": \"https://...\"\n    }\n}\n
    "},{"location":"how-to/platform/workstation-info.html","title":"Get information about workstations","text":"
    To list all workstations on Deep Origin, use:
     
    from deeporigin.platform import api\napi.get_workstations()\n
     
    This returns a list of objects, where each object correspond to a workstation. A typical entry looks like:
     
    {\n    \"attributes\": {\n        \"accessMethods\": [\n            {\n                \"icon\": \"/assets/icons/catalog-items/jupyterlab.svg\",\n                \"id\": \"jupyterlab\",\n                \"name\": \"JupyterLab\"\n            },\n            {\n                \"icon\": \"/assets/icons/catalog-items/code-server.svg\",\n                \"id\": \"code-server\",\n                \"name\": \"VS Code (web)\"\n            }\n        ],\n        \"accessSettings\": {\n            \"publicKey\": \"ssh-ed25519 ... \",\n            \"ssh\": true\n        },\n        \"autoStopIdleCPUThreshold\": 0,\n        \"autoStopIdleDuration\": 30,\n        \"blueprint\": \"deeporigin/deeporigin-python:staging\",\n        \"cloudProvider\": {\n            \"region\": \"us-west-2\",\n            \"vendor\": \"aws\"\n        },\n        \"clusterId\": \"3bb775e4-8be6-4936-a6b9\",\n        \"created\": \"2024-10-05T17:01:06.840Z\",\n        \"description\": \"dfd\",\n        \"drn\": \"drn:...\",\n        \"enableAutoStop\": true,\n        \"name\": \"forthcoming-tyrannosaurus-8fd\",\n        \"nextUserActions\": [\n            \"DELETE\"\n        ],\n        \"orgHandle\": \"deeporigin-com\",\n        \"requestedResources\": {\n            \"cpu\": 8,\n            \"gpu\": 0,\n            \"gpuSize\": \"NONE\",\n            \"memory\": 32,\n            \"storage\": 250\n        },\n        \"state\": {\n            \"error\": \"\",\n            \"isError\": false,\n            \"stage\": \"READY\",\n            \"status\": \"TERMINATED\"\n        },\n        \"status\": \"TERMINATED\",\n        \"summary\": \"\",\n        \"templateVersion\": \"v0.1.0\",\n        \"updated\": \"2024-10-07T12:46:46.511Z\",\n        \"userHandle\": \"google-apps|srinivas@deeporigin.com\",\n        \"volumeDrns\": [\n            \"...\"\n        ],\n        \"wasAutoStopped\": false\n    },\n    \"id\": \"...\",\n    \"type\": \"ComputeBench\"\n}\n
    "},{"location":"platform/index.html","title":"Platform API","text":"
    The Deep Origin CLI and python client allows you to control and interact with the Deep Origin platform. 
    "},{"location":"ref/data-hub/high-level-api.html","title":"API reference: High-level API","text":"
    How to use this reference
     
    This page contains information about each class and function in this module. This is meant as a detailed reference for this module. If you're looking an introduction, we recommend reviewing the How to section.
     
    The deeporigin.data_hub.api module contains high-level functions for interacting with your Deep Origin data hub.
    "},{"location":"ref/data-hub/high-level-api.html#src.data_hub.api.add_database_column","title":"add_database_column","text":"
    add_database_column(\n    *,\n    database_id: str,\n    type: DataType,\n    name: str,\n    cardinality: Cardinality = \"one\",\n    required: bool = False,\n    client=None,\n    _stash: bool = False\n)\n
     
    Add a column to a database.
     
    Parameters:
     Name Type Description Default database_id str 
    ID (or human ID) of a database on Deep Origin.
     required type DataType 
    type of the column. Should be one of DataType
     required name str 
    name of the column
     required cardinality Cardinality 
    cardinality of the column. Specifies whether cells in this column can contain or many items. Should be one of \"one\" or \"many\"
     'one' required bool 
    whether the column is required. If True, cells in this column cannot be empty
     False"},{"location":"ref/data-hub/high-level-api.html#src.data_hub.api.add_database_rows","title":"add_database_rows","text":"
    add_database_rows(\n    *,\n    database_id: str,\n    data: dict,\n    client=None,\n    _stash: bool = False\n) -> list[str]\n
     
    Add new data to a database.
     
    Use this function to add new rows, or fragments of rows, to a Deep Origin database.
     
    Parameters:
     Name Type Description Default database_id str 
    Human ID or System ID of the database
     required data dict 
    A dictionary where each key is a column name and each value is a list of values. All values should have the same length. Key names should match column names in the database.
     required 
    Returns:
     Type Description list[str] 
    A list of row IDs
    "},{"location":"ref/data-hub/high-level-api.html#src.data_hub.api.assign_files_to_cell","title":"assign_files_to_cell","text":"
    assign_files_to_cell(\n    *,\n    file_ids: list[str],\n    database_id: str,\n    column_id: str,\n    row_id: Optional[str] = None,\n    client=None,\n    _stash: bool = False\n)\n
     
    Assign existing file(s) to a cell
     
    Assign files to a cell in a database table, where the cell is identified by the database ID, row ID, and column ID.
     
    If row_id is None, a new row will be created.
     
    Parameters:
     Name Type Description Default file_ids list[str] 
    ID of the file
     required database_id str 
    ID of database to assign to
     required column_id str 
    ID of the column
     required row_id Optional[str] 
    ID of the row
     None"},{"location":"ref/data-hub/high-level-api.html#src.data_hub.api.convert_id_format","title":"convert_id_format","text":"
    convert_id_format(\n    *,\n    hids: Optional[Union[list[str], set[str]]] = None,\n    ids: Optional[Union[list[str], set[str]]] = None,\n    client=None,\n    _stash: bool = False\n) -> list[dict]\n
     
    Convert a list of human IDs to IDs or vice versa.
     
    Parameters:
     Name Type Description Default hids Optional[Union[list[str], set[str]]] 
    List of human IDs
     None ids Optional[Union[list[str], set[str]]] 
    List of IDs (system IDs)
     None"},{"location":"ref/data-hub/high-level-api.html#src.data_hub.api.create_database","title":"create_database","text":"
    create_database(\n    *,\n    name: str,\n    client=None,\n    _stash: bool = False,\n    parent_id: Optional[str] = None,\n    hid: Optional[str] = None,\n    hid_prefix: Optional[str] = None\n)\n
     
    Create a new database in the data hub
     
    A database contains rows of data.
     
    Parameters:
     Name Type Description Default name str 
    Name of the database to create
     required hid Optional[str] 
    Human ID. If not specified, the name will be used
     None parent_id Optional[str] 
    ID of the parent. If None, the folder is created at the root level
     None hid_prefix Optional[str] 
    Human ID prefix to be used for each row. If not specified, the name will be used
     None"},{"location":"ref/data-hub/high-level-api.html#src.data_hub.api.create_workspace","title":"create_workspace","text":"
    create_workspace(\n    *,\n    name: str,\n    hid: Optional[str] = None,\n    parent_id: Optional[str] = None,\n    client=None,\n    _stash: bool = False\n)\n
     
    Create a new folder (workspace) in the data hub
     
    A folder contains can contain other rows and databases.
     
    Parameters:
     Name Type Description Default name str 
    Name of the folder to create
     required hid Optional[str] 
    Human ID. If not specified, the name will be used
     None parent_id Optional[str] 
    ID of the parent. If None, the folder is created at the root level
     None"},{"location":"ref/data-hub/high-level-api.html#src.data_hub.api.download","title":"download","text":"
    download(\n    source: str,\n    destination: str,\n    *,\n    include_files: bool = False,\n    client=None,\n    _stash: bool = False\n) -> None\n
     
    Download resources from Deep Origin and save them to a local destination.
     
    Download databases, objects and other entities from your Deep Origin data hub and save them to local disk.
     Work in progress 
    All features in this function have not been implemented yet.
     
    Parameters:
     Name Type Description Default source str 
    ID (or human ID) of a resource on Deep Origin.
     required destination str 
    Path to local directory to save resources.
     required include_files bool 
    if True, download files in database.
     False"},{"location":"ref/data-hub/high-level-api.html#src.data_hub.api.download_database","title":"download_database","text":"
    download_database(\n    source: Any,\n    destination: str = getcwd(),\n    *,\n    include_files: bool = False,\n    client=None,\n    _stash: bool = False\n) -> None\n
     
    Download a database and save it to a CSV file on the local disk.
     
    Download a database from your Deep Origin data hub and save to local disk as a CSV file.
     
    Parameters:
     Name Type Description Default source Any 
    ID (or human ID) of a resource on Deep Origin.
     required destination str 
    Path to local directory to save resources.
     getcwd() include_files bool 
    if True, download files in database.
     False"},{"location":"ref/data-hub/high-level-api.html#src.data_hub.api.download_files","title":"download_files","text":"
    download_files(\n    *,\n    files: Optional[list[dict]] = None,\n    file_ids: Optional[list[str]] = None,\n    save_to_dir: Path | str = Path(\".\"),\n    use_file_names: bool = True,\n    client=None,\n    _stash: bool = False\n) -> None\n
     
    download multiple files in parallel to local disk
     
    Parameters:
     Name Type Description Default files Optional[list[dict]] 
    list of files to download. These can be a list of file_ids or a list of files as returned by api.list_files
     None save_to_dir Path | str 
    directory to save files to on local computer
     Path('.') use_file_names bool 
    If True, refer to files by name rather than ID.
     True"},{"location":"ref/data-hub/high-level-api.html#src.data_hub.api.get_cell_data","title":"get_cell_data","text":"
    get_cell_data(\n    *,\n    row_id: str,\n    column_name: str,\n    client=None,\n    _stash: bool = False\n) -> Any\n
     
    Extract data from a cell in a database, referenced by row_id and column_name.
     
    Returns the value in a single cell in a database.
     Caution 
    This function internally calls get_row_data, so it is not efficient to write a loop to get all values of cells from a row. It will be faster to call get_row_data directly.
     
    Parameters:
     Name Type Description Default row_id str 
    ID (or human ID) of a row.
     required column_name str 
    Name of column.
     required 
    Returns:
     Type Description Any 
    Value of that cell.
    "},{"location":"ref/data-hub/high-level-api.html#src.data_hub.api.get_columns","title":"get_columns","text":"
    get_columns(\n    row_id: str, *, client=None, _stash: bool = False\n) -> list[dict]\n
     
    Get information about the columns of a row or database.
     
    If row_id is a database, then column metadata and names are returned. If row_id is a row, then a dictionary of human IDs and values are returned.
     
    Parameters:
     Name Type Description Default row_id str 
    ID (or human ID) of a row or database on Deep Origin.
     required"},{"location":"ref/data-hub/high-level-api.html#src.data_hub.api.get_dataframe","title":"get_dataframe","text":"
    get_dataframe(\n    database_id: str,\n    *,\n    use_file_names: bool = True,\n    reference_format: IDFormat = \"human-id\",\n    return_type: DatabaseReturnType = \"dataframe\",\n    filter: Optional[dict] = None,\n    client=None,\n    _stash: bool = False\n)\n
     
    Generate a pandas.DataFrame or dictionary for a database.
     
    Download a database from your Deep Origin data hub and return it as a data frame or dictionary.
     
    Parameters:
     Name Type Description Default database_id str 
    ID (or human ID) of a database on Deep Origin.
     required use_file_names bool 
    If True, refer to files by name rather than ID.
     True reference_format IDFormat 
    Refer to rows on Deep Origin using human IDs or system IDs.
     'human-id' return_type DatabaseReturnType 
    Whether to return a pandas.Dataframe or a dictionary.
     'dataframe'"},{"location":"ref/data-hub/high-level-api.html#src.data_hub.api.get_notebook","title":"get_notebook","text":"
    get_notebook(\n    row_id: str, *, client=None, _stash: bool = False\n) -> list\n
     
    Get the notebook of a row, if it exists
     
    Parameters:
     Name Type Description Default row_id str 
    ID (or human ID) of a row on Deep Origin.
     required 
    Returns:
     Type Description list 
    The notebook of the row, returned as a list
     list 
    of blocks
    "},{"location":"ref/data-hub/high-level-api.html#src.data_hub.api.get_row_data","title":"get_row_data","text":"
    get_row_data(\n    row_id: str,\n    *,\n    use_column_keys: bool = False,\n    client=None,\n    _stash: bool = False\n) -> dict\n
     
    Get the data in a row.
     
    Read data from a row, and return it as a dictionary, where the keys are column names (or keys), and the values are the values of those cells.
     
    Parameters:
     Name Type Description Default row_id str 
    ID (or human ID) of a row or database on Deep Origin.
     required use_column_keys bool 
    if True, keys of dictionary are column keys.
     False 
    Raises:
     Type Description DeepOriginException 
    If row_id is not a row
    "},{"location":"ref/data-hub/high-level-api.html#src.data_hub.api.get_tree","title":"get_tree","text":"
    get_tree(\n    *,\n    include_rows: bool = True,\n    client=None,\n    _stash: bool = False\n) -> list\n
     
    Construct a tree of all folders (workspaces), databases and rows.
     
    Returns a tree that contains all folders, databases and (optionally) rows. The tree is returned as a dictionary, and children of each object are contained in a field called children.
     
    Parameters:
     Name Type Description Default include_rows bool 
    If True, rows are included in the tree.
     True 
    Returns:
     Type Description list 
    A dictionary describing the tree structure of all folders
     list 
    and databases.
    "},{"location":"ref/data-hub/high-level-api.html#src.data_hub.api.list_files","title":"list_files","text":"
    list_files(\n    *,\n    assigned_row_ids: Optional[list[str]] = None,\n    is_unassigned: Optional[bool] = None,\n    file_ids: Optional[list[str]] = None,\n    client=None,\n    _stash: bool = False\n) -> list\n
     
    List files, with option to filter by assigned rows, assigned status
     
    Returns a list of files.
     
    Parameters:
     Name Type Description Default assigned_row_ids Optional[list[str]] 
    List of IDs of rows that files are assigned to
     None is_unassigned Optional[bool] 
    If True only files that are unassigned will be returned
     None 
    Returns:
     Type Description list 
    A list of files, where each entry is an object that corresponds to a file on Deep Origin
    "},{"location":"ref/data-hub/high-level-api.html#src.data_hub.api.list_rows","title":"list_rows","text":"
    list_rows(\n    *,\n    parent_id: Optional[str] = None,\n    row_type: ObjectType = None,\n    parent_is_root: Optional[bool] = None,\n    client=None,\n    _stash: bool = False\n) -> list\n
     
    List rows in a database or folder (workspace).
     
    Returns a list of rows from folders and databases, based on the parent, row type, or whether the parent is the root.
     
    Parameters:
     Name Type Description Default parent_id Optional[str] 
    ID (or human ID) or the parent.
     None row_type ObjectType 
    One of row, folder, or database.
     None parent_is_root Optional[bool] 
    If True only rows that are children of the root will be returned.
     None 
    Returns:
     Type Description list 
    A list of objects, where each entry corresponds to a row.
    "},{"location":"ref/data-hub/high-level-api.html#src.data_hub.api.make_database_rows","title":"make_database_rows","text":"
    make_database_rows(\n    database_id: str,\n    n_rows: int = 1,\n    *,\n    client=None,\n    _stash: bool = False\n) -> dict\n
     
    Makes one or several new row(s) in a database table
     
    Parameters:
     Name Type Description Default database_id str 
    ID or Human ID of the database
     required n_rows int 
    Number of rows to create. Must be an integer greater than 0
     1 
    Returns:
     Type Description dict 
    A dictionary that conforms to a EnsureRowsResponse
    "},{"location":"ref/data-hub/high-level-api.html#src.data_hub.api.row_to_dict","title":"row_to_dict","text":"
    row_to_dict(\n    row: dict,\n    *,\n    file_ids: Optional[list] = None,\n    reference_ids: Optional[list] = None\n) -> dict\n
     
    convert a database row (as returned by api.list_database_rows) to a dictionary where keys are column IDs and values are the values in the row
     This function mutates inputs 
    This function mutates file_ids and reference_ids
     
    Parameters:
     Name Type Description Default row dict 
    database row (as returned by api.list_database_rows)
     required file_ids Optional[list] 
    list of file IDs, will be mutated in-place
     None reference_ids Optional[list] 
    list of reference IDs, will be mutated in-place
     None 
    Returns:
     Type Description dict 
    dict
    "},{"location":"ref/data-hub/high-level-api.html#src.data_hub.api.set_cell_data","title":"set_cell_data","text":"
    set_cell_data(\n    value: Any,\n    *,\n    database_id: str,\n    row_id: str,\n    column_id: str,\n    client=None,\n    _stash: bool = False\n) -> Any\n
     
    Set data in a cell to some value.
     
    Parameters:
     Name Type Description Default value Any 
    Value to set in the cell
     required database_id str 
    ID (or human ID) of a database
     required row_id str 
    ID (or human ID) of a row
     required column_id str 
    ID (or human ID) of a column
     required"},{"location":"ref/data-hub/high-level-api.html#src.data_hub.api.set_data_in_cells","title":"set_data_in_cells","text":"
    set_data_in_cells(\n    *,\n    values: list,\n    row_ids: list[str],\n    column_id: str,\n    database_id: str,\n    columns: Optional[list[dict]] = None,\n    client=None,\n    _stash: bool = False\n)\n
     
    Set data in multiple cells to some value.
    "},{"location":"ref/data-hub/high-level-api.html#src.data_hub.api.upload_file","title":"upload_file","text":"
    upload_file(\n    file_path: str,\n    *,\n    client=None,\n    _stash: bool = False,\n    compute_hash: bool = True\n)\n
     
    Upload a file to Deep Origin.
     
    This upload files to your Deep Origin data hub. To assign this file to a cell, next run assign_files_to_cell
     
    Parameters:
     Name Type Description Default file_path str 
    Path to the file to upload
     required"},{"location":"ref/data-hub/high-level-api.html#src.data_hub.api.upload_file_to_new_database_row","title":"upload_file_to_new_database_row","text":"
    upload_file_to_new_database_row(\n    *,\n    database_id: str,\n    file_path: str,\n    column_id: str,\n    client=None,\n    _stash: bool = False\n)\n
     
    Upload a file to a new row in a database.
     
    Upload a file to a new row in a database. This utility function wraps two other functions:
     
       
    • upload_file
      •  
    • assign_files_to_cell
      •  
     
    Parameters:
     Name Type Description Default database_id str 
    ID (or human ID) of a database.
     required file_path str 
    Path to the file to upload.
     required column_id str 
    ID (or human ID) of a column in the database.
     required"},{"location":"ref/data-hub/low-level-api.html","title":"API reference: Low-level API","text":""},{"location":"ref/data-hub/low-level-api.html#background","title":"Background","text":"
    We use automatically generated code to implement a low-level Python SDK that connects to the Deep Origin data hub API. This page describes that API. In most cases, you will not need to know how this works, nor will you need to use it.
     
    Using the methods in the DeeporiginData class
     
    The deeporigin.api module provides wrappers that allow you to use methods in the deeporigin_data.DeeporiginData class, without needing to instantiate an object and configure it. Each method of this class is exposed as a function with the same name. These functions enable you to easily use the methods of the deeporigin_data.DeeporiginData class.
     
    For example, to use the list_files method in the DeeporiginData class, run:
     
    from deeporigin.data_hub import api\napi.list_files()\n
     
    Your IDE should be able to provide information about the arguments and return types of these functions by typing api.list_files( and then pressing tab.    
    "},{"location":"ref/data-hub/low-level-api.html#deeporigin_data._client.AsyncDeeporiginData","title":"AsyncDeeporiginData","text":"
                   Bases: AsyncAPIClient
    "},{"location":"ref/data-hub/low-level-api.html#deeporigin_data._client.AsyncDeeporiginData.__init__","title":"__init__","text":"
    __init__(\n    *,\n    token: str | None = None,\n    org_id: str | None = None,\n    base_url: str | URL | None = None,\n    timeout: Union[\n        float, Timeout, None, NotGiven\n    ] = NOT_GIVEN,\n    max_retries: int = DEFAULT_MAX_RETRIES,\n    default_headers: Mapping[str, str] | None = None,\n    default_query: Mapping[str, object] | None = None,\n    http_client: AsyncClient | None = None,\n    _strict_response_validation: bool = False\n) -> None\n
     
    This automatically infers the following arguments from their corresponding environment variables if they are not provided: - token from ORG_BEARER_TOKEN - org_id from ORG_ID
    "},{"location":"ref/data-hub/low-level-api.html#deeporigin_data._client.AsyncDeeporiginData.add_database_column","title":"add_database_column  async","text":"
    add_database_column(\n    *,\n    column: Column,\n    database_id: str,\n    extra_headers: Headers | None = None,\n    extra_query: Query | None = None,\n    extra_body: Body | None = None,\n    timeout: float | Timeout | None | NotGiven = NOT_GIVEN\n) -> AddDatabaseColumnResponse\n
     
    Add a column to a database.
     
    Parameters:
     Name Type Description Default extra_headers Headers | None 
    Send extra headers
     None extra_query Query | None 
    Add additional query parameters to the request
     None extra_body Body | None 
    Add additional JSON properties to the request
     None timeout float | Timeout | None | NotGiven 
    Override the client-level default timeout for this request, in seconds
     NOT_GIVEN"},{"location":"ref/data-hub/low-level-api.html#deeporigin_data._client.AsyncDeeporiginData.archive_files","title":"archive_files  async","text":"
    archive_files(\n    *,\n    file_ids: List[str],\n    extra_headers: Headers | None = None,\n    extra_query: Query | None = None,\n    extra_body: Body | None = None,\n    timeout: float | Timeout | None | NotGiven = NOT_GIVEN\n) -> object\n
     
    Archive files by their ids.
     
    Parameters:
     Name Type Description Default extra_headers Headers | None 
    Send extra headers
     None extra_query Query | None 
    Add additional query parameters to the request
     None extra_body Body | None 
    Add additional JSON properties to the request
     None timeout float | Timeout | None | NotGiven 
    Override the client-level default timeout for this request, in seconds
     NOT_GIVEN"},{"location":"ref/data-hub/low-level-api.html#deeporigin_data._client.AsyncDeeporiginData.chat_create_thread","title":"chat_create_thread  async","text":"
    chat_create_thread(\n    *,\n    body: object,\n    extra_headers: Headers | None = None,\n    extra_query: Query | None = None,\n    extra_body: Body | None = None,\n    timeout: float | Timeout | None | NotGiven = NOT_GIVEN\n) -> ChatCreateThreadResponse\n
     
    Create a new chat thread.
     
    Parameters:
     Name Type Description Default extra_headers Headers | None 
    Send extra headers
     None extra_query Query | None 
    Add additional query parameters to the request
     None extra_body Body | None 
    Add additional JSON properties to the request
     None timeout float | Timeout | None | NotGiven 
    Override the client-level default timeout for this request, in seconds
     NOT_GIVEN"},{"location":"ref/data-hub/low-level-api.html#deeporigin_data._client.AsyncDeeporiginData.chat_list_messages","title":"chat_list_messages  async","text":"
    chat_list_messages(\n    *,\n    thread_id: str,\n    extra_headers: Headers | None = None,\n    extra_query: Query | None = None,\n    extra_body: Body | None = None,\n    timeout: float | Timeout | None | NotGiven = NOT_GIVEN\n) -> ChatListMessagesResponse\n
     
    List messages in a chat thread.
     
    Parameters:
     Name Type Description Default extra_headers Headers | None 
    Send extra headers
     None extra_query Query | None 
    Add additional query parameters to the request
     None extra_body Body | None 
    Add additional JSON properties to the request
     None timeout float | Timeout | None | NotGiven 
    Override the client-level default timeout for this request, in seconds
     NOT_GIVEN"},{"location":"ref/data-hub/low-level-api.html#deeporigin_data._client.AsyncDeeporiginData.chat_send_message","title":"chat_send_message  async","text":"
    chat_send_message(\n    *,\n    messages: Iterable[Message],\n    thread_id: str,\n    context: Context | NotGiven = NOT_GIVEN,\n    extra_headers: Headers | None = None,\n    extra_query: Query | None = None,\n    extra_body: Body | None = None,\n    timeout: float | Timeout | None | NotGiven = NOT_GIVEN\n) -> None\n
     
    Send a chat message to the Deep Origin assistant and streams results via SSE.
     
    Parameters:
     Name Type Description Default extra_headers Headers | None 
    Send extra headers
     None extra_query Query | None 
    Add additional query parameters to the request
     None extra_body Body | None 
    Add additional JSON properties to the request
     None timeout float | Timeout | None | NotGiven 
    Override the client-level default timeout for this request, in seconds
     NOT_GIVEN"},{"location":"ref/data-hub/low-level-api.html#deeporigin_data._client.AsyncDeeporiginData.close","title":"close  async","text":"
    close() -> None\n
     
    Close the underlying HTTPX client.
     
    The client will not be usable after this.
    "},{"location":"ref/data-hub/low-level-api.html#deeporigin_data._client.AsyncDeeporiginData.configure_column_select_options","title":"configure_column_select_options  async","text":"
    configure_column_select_options(\n    *,\n    column_id: str,\n    database_id: str,\n    option_configuration: Iterable[OptionConfiguration],\n    extra_headers: Headers | None = None,\n    extra_query: Query | None = None,\n    extra_body: Body | None = None,\n    timeout: float | Timeout | None | NotGiven = NOT_GIVEN\n) -> ConfigureColumnSelectOptionsResponse\n
     
    Configure column select options.
     
    Supports both adding and removing options.
     
    Parameters:
     Name Type Description Default extra_headers Headers | None 
    Send extra headers
     None extra_query Query | None 
    Add additional query parameters to the request
     None extra_body Body | None 
    Add additional JSON properties to the request
     None timeout float | Timeout | None | NotGiven 
    Override the client-level default timeout for this request, in seconds
     NOT_GIVEN"},{"location":"ref/data-hub/low-level-api.html#deeporigin_data._client.AsyncDeeporiginData.convert_id_format","title":"convert_id_format  async","text":"
    convert_id_format(\n    *,\n    conversions: Iterable[Conversion],\n    extra_headers: Headers | None = None,\n    extra_query: Query | None = None,\n    extra_body: Body | None = None,\n    timeout: float | Timeout | None | NotGiven = NOT_GIVEN\n) -> ConvertIDFormatResponse\n
     
    Converts between system IDs and human IDs (HIDs).
     
    Parameters:
     Name Type Description Default extra_headers Headers | None 
    Send extra headers
     None extra_query Query | None 
    Add additional query parameters to the request
     None extra_body Body | None 
    Add additional JSON properties to the request
     None timeout float | Timeout | None | NotGiven 
    Override the client-level default timeout for this request, in seconds
     NOT_GIVEN"},{"location":"ref/data-hub/low-level-api.html#deeporigin_data._client.AsyncDeeporiginData.copy","title":"copy","text":"
    copy(\n    *,\n    token: str | None = None,\n    org_id: str | None = None,\n    base_url: str | URL | None = None,\n    timeout: float | Timeout | None | NotGiven = NOT_GIVEN,\n    http_client: AsyncClient | None = None,\n    max_retries: int | NotGiven = NOT_GIVEN,\n    default_headers: Mapping[str, str] | None = None,\n    set_default_headers: Mapping[str, str] | None = None,\n    default_query: Mapping[str, object] | None = None,\n    set_default_query: Mapping[str, object] | None = None,\n    _extra_kwargs: Mapping[str, Any] = {}\n) -> Self\n
     
    Create a new client instance re-using the same options given to the current client with optional overriding.
    "},{"location":"ref/data-hub/low-level-api.html#deeporigin_data._client.AsyncDeeporiginData.create_database","title":"create_database  async","text":"
    create_database(\n    *,\n    database: Database,\n    extra_headers: Headers | None = None,\n    extra_query: Query | None = None,\n    extra_body: Body | None = None,\n    timeout: float | Timeout | None | NotGiven = NOT_GIVEN\n) -> CreateDatabaseResponse\n
     
    Create a new database.
     
    Parameters:
     Name Type Description Default extra_headers Headers | None 
    Send extra headers
     None extra_query Query | None 
    Add additional query parameters to the request
     None extra_body Body | None 
    Add additional JSON properties to the request
     None timeout float | Timeout | None | NotGiven 
    Override the client-level default timeout for this request, in seconds
     NOT_GIVEN"},{"location":"ref/data-hub/low-level-api.html#deeporigin_data._client.AsyncDeeporiginData.create_file_download_url","title":"create_file_download_url  async","text":"
    create_file_download_url(\n    *,\n    file_id: str,\n    extra_headers: Headers | None = None,\n    extra_query: Query | None = None,\n    extra_body: Body | None = None,\n    timeout: float | Timeout | None | NotGiven = NOT_GIVEN\n) -> CreateFileDownloadURLResponse\n
     
    Returns a pre-signed S3 URL.
     
    Parameters:
     Name Type Description Default file_id str 
    Deep Origin system ID.
     required extra_headers Headers | None 
    Send extra headers
     None extra_query Query | None 
    Add additional query parameters to the request
     None extra_body Body | None 
    Add additional JSON properties to the request
     None timeout float | Timeout | None | NotGiven 
    Override the client-level default timeout for this request, in seconds
     NOT_GIVEN"},{"location":"ref/data-hub/low-level-api.html#deeporigin_data._client.AsyncDeeporiginData.create_file_upload","title":"create_file_upload  async","text":"
    create_file_upload(\n    *,\n    content_length: str,\n    name: str,\n    checksum_sha256: str | NotGiven = NOT_GIVEN,\n    content_type: str | NotGiven = NOT_GIVEN,\n    extra_headers: Headers | None = None,\n    extra_query: Query | None = None,\n    extra_body: Body | None = None,\n    timeout: float | Timeout | None | NotGiven = NOT_GIVEN\n) -> CreateFileUploadResponse\n
     
    Create a file upload URL.
     
    Typically this is creating a pre-signed S3 URL.
     
    Parameters:
     Name Type Description Default checksum_sha256 str | NotGiven 
    Base64 encoded SHA256 checksum of the file.
     NOT_GIVEN extra_headers Headers | None 
    Send extra headers
     None extra_query Query | None 
    Add additional query parameters to the request
     None extra_body Body | None 
    Add additional JSON properties to the request
     None timeout float | Timeout | None | NotGiven 
    Override the client-level default timeout for this request, in seconds
     NOT_GIVEN"},{"location":"ref/data-hub/low-level-api.html#deeporigin_data._client.AsyncDeeporiginData.create_workspace","title":"create_workspace  async","text":"
    create_workspace(\n    *,\n    workspace: Workspace,\n    extra_headers: Headers | None = None,\n    extra_query: Query | None = None,\n    extra_body: Body | None = None,\n    timeout: float | Timeout | None | NotGiven = NOT_GIVEN\n) -> CreateWorkspaceResponse\n
     
    Create a new workspace.
     
    Parameters:
     Name Type Description Default extra_headers Headers | None 
    Send extra headers
     None extra_query Query | None 
    Add additional query parameters to the request
     None extra_body Body | None 
    Add additional JSON properties to the request
     None timeout float | Timeout | None | NotGiven 
    Override the client-level default timeout for this request, in seconds
     NOT_GIVEN"},{"location":"ref/data-hub/low-level-api.html#deeporigin_data._client.AsyncDeeporiginData.delete_database","title":"delete_database  async","text":"
    delete_database(\n    *,\n    database_id: str,\n    extra_headers: Headers | None = None,\n    extra_query: Query | None = None,\n    extra_body: Body | None = None,\n    timeout: float | Timeout | None | NotGiven = NOT_GIVEN\n) -> DeleteDatabaseResponse\n
     
    Permanently deletes a database.
     
    Parameters:
     Name Type Description Default extra_headers Headers | None 
    Send extra headers
     None extra_query Query | None 
    Add additional query parameters to the request
     None extra_body Body | None 
    Add additional JSON properties to the request
     None timeout float | Timeout | None | NotGiven 
    Override the client-level default timeout for this request, in seconds
     NOT_GIVEN"},{"location":"ref/data-hub/low-level-api.html#deeporigin_data._client.AsyncDeeporiginData.delete_database_column","title":"delete_database_column  async","text":"
    delete_database_column(\n    *,\n    column_id: str,\n    database_id: str,\n    extra_headers: Headers | None = None,\n    extra_query: Query | None = None,\n    extra_body: Body | None = None,\n    timeout: float | Timeout | None | NotGiven = NOT_GIVEN\n) -> DeleteDatabaseColumnResponse\n
     
    Delete a column from a database.
     
    Parameters:
     Name Type Description Default extra_headers Headers | None 
    Send extra headers
     None extra_query Query | None 
    Add additional query parameters to the request
     None extra_body Body | None 
    Add additional JSON properties to the request
     None timeout float | Timeout | None | NotGiven 
    Override the client-level default timeout for this request, in seconds
     NOT_GIVEN"},{"location":"ref/data-hub/low-level-api.html#deeporigin_data._client.AsyncDeeporiginData.delete_rows","title":"delete_rows  async","text":"
    delete_rows(\n    *,\n    database_id: str,\n    delete_all: bool | NotGiven = NOT_GIVEN,\n    row_ids: List[str] | NotGiven = NOT_GIVEN,\n    extra_headers: Headers | None = None,\n    extra_query: Query | None = None,\n    extra_body: Body | None = None,\n    timeout: float | Timeout | None | NotGiven = NOT_GIVEN\n) -> DeleteRowsResponse\n
     
    Delete rows by their ids.
     
    Parameters:
     Name Type Description Default delete_all bool | NotGiven 
    When true, deletes all rows in the table except rows with the specified   rowIds.
     NOT_GIVEN row_ids List[str] | NotGiven 
    List of row IDs to delete.
     NOT_GIVEN extra_headers Headers | None 
    Send extra headers
     None extra_query Query | None 
    Add additional query parameters to the request
     None extra_body Body | None 
    Add additional JSON properties to the request
     None timeout float | Timeout | None | NotGiven 
    Override the client-level default timeout for this request, in seconds
     NOT_GIVEN"},{"location":"ref/data-hub/low-level-api.html#deeporigin_data._client.AsyncDeeporiginData.delete_workspace","title":"delete_workspace  async","text":"
    delete_workspace(\n    *,\n    workspace_id: str,\n    extra_headers: Headers | None = None,\n    extra_query: Query | None = None,\n    extra_body: Body | None = None,\n    timeout: float | Timeout | None | NotGiven = NOT_GIVEN\n) -> DeleteWorkspaceResponse\n
     
    Permanently deletes a workspace and all its children.
     
    Parameters:
     Name Type Description Default extra_headers Headers | None 
    Send extra headers
     None extra_query Query | None 
    Add additional query parameters to the request
     None extra_body Body | None 
    Add additional JSON properties to the request
     None timeout float | Timeout | None | NotGiven 
    Override the client-level default timeout for this request, in seconds
     NOT_GIVEN"},{"location":"ref/data-hub/low-level-api.html#deeporigin_data._client.AsyncDeeporiginData.describe_code_execution","title":"describe_code_execution  async","text":"
    describe_code_execution(\n    *,\n    id: str,\n    extra_headers: Headers | None = None,\n    extra_query: Query | None = None,\n    extra_body: Body | None = None,\n    timeout: float | Timeout | None | NotGiven = NOT_GIVEN\n) -> DescribeCodeExecutionResponse\n
     
    Returns information about a particular code execution.
     
    Parameters:
     Name Type Description Default extra_headers Headers | None 
    Send extra headers
     None extra_query Query | None 
    Add additional query parameters to the request
     None extra_body Body | None 
    Add additional JSON properties to the request
     None timeout float | Timeout | None | NotGiven 
    Override the client-level default timeout for this request, in seconds
     NOT_GIVEN"},{"location":"ref/data-hub/low-level-api.html#deeporigin_data._client.AsyncDeeporiginData.describe_database","title":"describe_database  async","text":"
    describe_database(\n    *,\n    database_id: str,\n    extra_headers: Headers | None = None,\n    extra_query: Query | None = None,\n    extra_body: Body | None = None,\n    timeout: float | Timeout | None | NotGiven = NOT_GIVEN\n) -> DescribeDatabaseResponse\n
     
    Describe a database
     
    Parameters:
     Name Type Description Default extra_headers Headers | None 
    Send extra headers
     None extra_query Query | None 
    Add additional query parameters to the request
     None extra_body Body | None 
    Add additional JSON properties to the request
     None timeout float | Timeout | None | NotGiven 
    Override the client-level default timeout for this request, in seconds
     NOT_GIVEN"},{"location":"ref/data-hub/low-level-api.html#deeporigin_data._client.AsyncDeeporiginData.describe_database_stats","title":"describe_database_stats  async","text":"
    describe_database_stats(\n    *,\n    database_id: str,\n    extra_headers: Headers | None = None,\n    extra_query: Query | None = None,\n    extra_body: Body | None = None,\n    timeout: float | Timeout | None | NotGiven = NOT_GIVEN\n) -> DescribeDatabaseStatsResponse\n
     
    Returns aggregation information about a particular database.
     
    Parameters:
     Name Type Description Default extra_headers Headers | None 
    Send extra headers
     None extra_query Query | None 
    Add additional query parameters to the request
     None extra_body Body | None 
    Add additional JSON properties to the request
     None timeout float | Timeout | None | NotGiven 
    Override the client-level default timeout for this request, in seconds
     NOT_GIVEN"},{"location":"ref/data-hub/low-level-api.html#deeporigin_data._client.AsyncDeeporiginData.describe_file","title":"describe_file  async","text":"
    describe_file(\n    *,\n    file_id: str,\n    extra_headers: Headers | None = None,\n    extra_query: Query | None = None,\n    extra_body: Body | None = None,\n    timeout: float | Timeout | None | NotGiven = NOT_GIVEN\n) -> DescribeFileResponse\n
     
    Describe a file by its ID.
     
    Parameters:
     Name Type Description Default file_id str 
    Deep Origin system ID.
     required extra_headers Headers | None 
    Send extra headers
     None extra_query Query | None 
    Add additional query parameters to the request
     None extra_body Body | None 
    Add additional JSON properties to the request
     None timeout float | Timeout | None | NotGiven 
    Override the client-level default timeout for this request, in seconds
     NOT_GIVEN"},{"location":"ref/data-hub/low-level-api.html#deeporigin_data._client.AsyncDeeporiginData.describe_row","title":"describe_row  async","text":"
    describe_row(\n    *,\n    row_id: str,\n    column_selection: (\n        ColumnSelection | NotGiven\n    ) = NOT_GIVEN,\n    fields: bool | NotGiven = NOT_GIVEN,\n    extra_headers: Headers | None = None,\n    extra_query: Query | None = None,\n    extra_body: Body | None = None,\n    timeout: float | Timeout | None | NotGiven = NOT_GIVEN\n) -> DescribeRowResponse\n
     
    Deprecated.
     
    Use DescribeDatabaseRow, DescribeDatabase, or DescribeWorkspace instead.
     
    Parameters:
     Name Type Description Default column_selection ColumnSelection | NotGiven 
    Select columns for inclusion/exclusion.
     NOT_GIVEN extra_headers Headers | None 
    Send extra headers
     None extra_query Query | None 
    Add additional query parameters to the request
     None extra_body Body | None 
    Add additional JSON properties to the request
     None timeout float | Timeout | None | NotGiven 
    Override the client-level default timeout for this request, in seconds
     NOT_GIVEN"},{"location":"ref/data-hub/low-level-api.html#deeporigin_data._client.AsyncDeeporiginData.describe_workspace","title":"describe_workspace  async","text":"
    describe_workspace(\n    *,\n    workspace_id: str,\n    extra_headers: Headers | None = None,\n    extra_query: Query | None = None,\n    extra_body: Body | None = None,\n    timeout: float | Timeout | None | NotGiven = NOT_GIVEN\n) -> DescribeWorkspaceResponse\n
     
    Describe a workspace
     
    Parameters:
     Name Type Description Default extra_headers Headers | None 
    Send extra headers
     None extra_query Query | None 
    Add additional query parameters to the request
     None extra_body Body | None 
    Add additional JSON properties to the request
     None timeout float | Timeout | None | NotGiven 
    Override the client-level default timeout for this request, in seconds
     NOT_GIVEN"},{"location":"ref/data-hub/low-level-api.html#deeporigin_data._client.AsyncDeeporiginData.download_file","title":"download_file  async","text":"
    download_file(\n    *,\n    extra_headers: Headers | None = None,\n    extra_query: Query | None = None,\n    extra_body: Body | None = None,\n    timeout: float | Timeout | None | NotGiven = NOT_GIVEN\n) -> None\n
     
    Returns a 303 redirect to a pre-signed S3 URL.
    "},{"location":"ref/data-hub/low-level-api.html#deeporigin_data._client.AsyncDeeporiginData.ensure_rows","title":"ensure_rows  async","text":"
    ensure_rows(\n    *,\n    database_id: str,\n    rows: Iterable[Row],\n    check_previous_value: bool | NotGiven = NOT_GIVEN,\n    extra_headers: Headers | None = None,\n    extra_query: Query | None = None,\n    extra_body: Body | None = None,\n    timeout: float | Timeout | None | NotGiven = NOT_GIVEN\n) -> EnsureRowsResponse\n
     
    Either creates or updates an existing row.
     
    Supports updates to both system and user defined columns.
     
    Parameters:
     Name Type Description Default extra_headers Headers | None 
    Send extra headers
     None extra_query Query | None 
    Add additional query parameters to the request
     None extra_body Body | None 
    Add additional JSON properties to the request
     None timeout float | Timeout | None | NotGiven 
    Override the client-level default timeout for this request, in seconds
     NOT_GIVEN"},{"location":"ref/data-hub/low-level-api.html#deeporigin_data._client.AsyncDeeporiginData.execute_code_async","title":"execute_code_async  async","text":"
    execute_code_async(\n    *,\n    code: str,\n    code_language: Literal[\"python\"],\n    extra_headers: Headers | None = None,\n    extra_query: Query | None = None,\n    extra_body: Body | None = None,\n    timeout: float | Timeout | None | NotGiven = NOT_GIVEN\n) -> ExecuteCodeAsyncResponse\n
     
    Execute code asynchronously.
     
    Parameters:
     Name Type Description Default extra_headers Headers | None 
    Send extra headers
     None extra_query Query | None 
    Add additional query parameters to the request
     None extra_body Body | None 
    Add additional JSON properties to the request
     None timeout float | Timeout | None | NotGiven 
    Override the client-level default timeout for this request, in seconds
     NOT_GIVEN"},{"location":"ref/data-hub/low-level-api.html#deeporigin_data._client.AsyncDeeporiginData.execute_code_sync","title":"execute_code_sync  async","text":"
    execute_code_sync(\n    *,\n    code: str,\n    code_language: Literal[\"python\"],\n    extra_headers: Headers | None = None,\n    extra_query: Query | None = None,\n    extra_body: Body | None = None,\n    timeout: float | Timeout | None | NotGiven = NOT_GIVEN\n) -> ExecuteCodeSyncResponse\n
     
    Execute code synchronously.
     
    Parameters:
     Name Type Description Default extra_headers Headers | None 
    Send extra headers
     None extra_query Query | None 
    Add additional query parameters to the request
     None extra_body Body | None 
    Add additional JSON properties to the request
     None timeout float | Timeout | None | NotGiven 
    Override the client-level default timeout for this request, in seconds
     NOT_GIVEN"},{"location":"ref/data-hub/low-level-api.html#deeporigin_data._client.AsyncDeeporiginData.get_code_execution_result","title":"get_code_execution_result  async","text":"
    get_code_execution_result(\n    *,\n    id: str,\n    extra_headers: Headers | None = None,\n    extra_query: Query | None = None,\n    extra_body: Body | None = None,\n    timeout: float | Timeout | None | NotGiven = NOT_GIVEN\n) -> object\n
     
    Returns the result of a code execution.
     
    Parameters:
     Name Type Description Default id str 
    Deep Origin system ID.
     required extra_headers Headers | None 
    Send extra headers
     None extra_query Query | None 
    Add additional query parameters to the request
     None extra_body Body | None 
    Add additional JSON properties to the request
     None timeout float | Timeout | None | NotGiven 
    Override the client-level default timeout for this request, in seconds
     NOT_GIVEN"},{"location":"ref/data-hub/low-level-api.html#deeporigin_data._client.AsyncDeeporiginData.import_rows","title":"import_rows  async","text":"
    import_rows(\n    *,\n    database_id: str,\n    add_columns: Iterable[AddColumn] | NotGiven = NOT_GIVEN,\n    creation_block_id: str | NotGiven = NOT_GIVEN,\n    creation_parent_id: str | NotGiven = NOT_GIVEN,\n    extra_headers: Headers | None = None,\n    extra_query: Query | None = None,\n    extra_body: Body | None = None,\n    timeout: float | Timeout | None | NotGiven = NOT_GIVEN\n) -> ImportRowsResponse\n
     
    Creates new rows from CSV data.
     
    Parameters:
     Name Type Description Default add_columns Iterable[AddColumn] | NotGiven 
    Optionally add additional columns to the database during import.
     NOT_GIVEN extra_headers Headers | None 
    Send extra headers
     None extra_query Query | None 
    Add additional query parameters to the request
     None extra_body Body | None 
    Add additional JSON properties to the request
     None timeout float | Timeout | None | NotGiven 
    Override the client-level default timeout for this request, in seconds
     NOT_GIVEN"},{"location":"ref/data-hub/low-level-api.html#deeporigin_data._client.AsyncDeeporiginData.list_database_column_unique_values_v2","title":"list_database_column_unique_values_v2  async","text":"
    list_database_column_unique_values_v2(\n    *,\n    column_id: str,\n    database_id: str,\n    extra_headers: Headers | None = None,\n    extra_query: Query | None = None,\n    extra_body: Body | None = None,\n    timeout: float | Timeout | None | NotGiven = NOT_GIVEN\n) -> ListDatabaseColumnUniqueValuesV2Response\n
     
    Returns the unique values for every cell within the column.
     
    Parameters:
     Name Type Description Default extra_headers Headers | None 
    Send extra headers
     None extra_query Query | None 
    Add additional query parameters to the request
     None extra_body Body | None 
    Add additional JSON properties to the request
     None timeout float | Timeout | None | NotGiven 
    Override the client-level default timeout for this request, in seconds
     NOT_GIVEN"},{"location":"ref/data-hub/low-level-api.html#deeporigin_data._client.AsyncDeeporiginData.list_database_rows","title":"list_database_rows  async","text":"
    list_database_rows(\n    *,\n    database_row_id: str,\n    column_selection: (\n        ColumnSelection | NotGiven\n    ) = NOT_GIVEN,\n    filter: Filter | NotGiven = NOT_GIVEN,\n    limit: int | NotGiven = NOT_GIVEN,\n    offset: int | NotGiven = NOT_GIVEN,\n    row_sort: Iterable[RowSort] | NotGiven = NOT_GIVEN,\n    extra_headers: Headers | None = None,\n    extra_query: Query | None = None,\n    extra_body: Body | None = None,\n    timeout: float | Timeout | None | NotGiven = NOT_GIVEN\n) -> ListDatabaseRowsResponse\n
     
    List database rows with full row data.
     
    Parameters:
     Name Type Description Default column_selection ColumnSelection | NotGiven 
    Select columns for inclusion/exclusion.
     NOT_GIVEN row_sort Iterable[RowSort] | NotGiven 
    Sort rows by column.
     NOT_GIVEN extra_headers Headers | None 
    Send extra headers
     None extra_query Query | None 
    Add additional query parameters to the request
     None extra_body Body | None 
    Add additional JSON properties to the request
     None timeout float | Timeout | None | NotGiven 
    Override the client-level default timeout for this request, in seconds
     NOT_GIVEN"},{"location":"ref/data-hub/low-level-api.html#deeporigin_data._client.AsyncDeeporiginData.list_files","title":"list_files  async","text":"
    list_files(\n    *,\n    filters: Iterable[Filter] | NotGiven = NOT_GIVEN,\n    extra_headers: Headers | None = None,\n    extra_query: Query | None = None,\n    extra_body: Body | None = None,\n    timeout: float | Timeout | None | NotGiven = NOT_GIVEN\n) -> ListFilesResponse\n
     
    Returns a list of files using the filters.
     
    Parameters:
     Name Type Description Default extra_headers Headers | None 
    Send extra headers
     None extra_query Query | None 
    Add additional query parameters to the request
     None extra_body Body | None 
    Add additional JSON properties to the request
     None timeout float | Timeout | None | NotGiven 
    Override the client-level default timeout for this request, in seconds
     NOT_GIVEN"},{"location":"ref/data-hub/low-level-api.html#deeporigin_data._client.AsyncDeeporiginData.list_mentions","title":"list_mentions  async","text":"
    list_mentions(\n    *,\n    query: str,\n    extra_headers: Headers | None = None,\n    extra_query: Query | None = None,\n    extra_body: Body | None = None,\n    timeout: float | Timeout | None | NotGiven = NOT_GIVEN\n) -> ListMentionsResponse\n
     
    Returns entities that can be mentioned in a notebook.
     
    Parameters:
     Name Type Description Default extra_headers Headers | None 
    Send extra headers
     None extra_query Query | None 
    Add additional query parameters to the request
     None extra_body Body | None 
    Add additional JSON properties to the request
     None timeout float | Timeout | None | NotGiven 
    Override the client-level default timeout for this request, in seconds
     NOT_GIVEN"},{"location":"ref/data-hub/low-level-api.html#deeporigin_data._client.AsyncDeeporiginData.list_row_back_references","title":"list_row_back_references  async","text":"
    list_row_back_references(\n    *,\n    database_id: str,\n    row_id: str,\n    extra_headers: Headers | None = None,\n    extra_query: Query | None = None,\n    extra_body: Body | None = None,\n    timeout: float | Timeout | None | NotGiven = NOT_GIVEN\n) -> ListRowBackReferencesResponse\n
     
    Finds all the places a row is referenced.
     
    Parameters:
     Name Type Description Default extra_headers Headers | None 
    Send extra headers
     None extra_query Query | None 
    Add additional query parameters to the request
     None extra_body Body | None 
    Add additional JSON properties to the request
     None timeout float | Timeout | None | NotGiven 
    Override the client-level default timeout for this request, in seconds
     NOT_GIVEN"},{"location":"ref/data-hub/low-level-api.html#deeporigin_data._client.AsyncDeeporiginData.list_rows","title":"list_rows  async","text":"
    list_rows(\n    *,\n    filters: Iterable[Filter],\n    extra_headers: Headers | None = None,\n    extra_query: Query | None = None,\n    extra_body: Body | None = None,\n    timeout: float | Timeout | None | NotGiven = NOT_GIVEN\n) -> ListRowsResponse\n
     
    Lists rows at a given depth in the hierarchy.
     
    Parameters:
     Name Type Description Default extra_headers Headers | None 
    Send extra headers
     None extra_query Query | None 
    Add additional query parameters to the request
     None extra_body Body | None 
    Add additional JSON properties to the request
     None timeout float | Timeout | None | NotGiven 
    Override the client-level default timeout for this request, in seconds
     NOT_GIVEN"},{"location":"ref/data-hub/low-level-api.html#deeporigin_data._client.AsyncDeeporiginData.lock_database","title":"lock_database  async","text":"
    lock_database(\n    *,\n    database_id: str,\n    extra_headers: Headers | None = None,\n    extra_query: Query | None = None,\n    extra_body: Body | None = None,\n    timeout: float | Timeout | None | NotGiven = NOT_GIVEN\n) -> LockDatabaseResponse\n
     
    A locked database cannot be edited.
     
    Parameters:
     Name Type Description Default extra_headers Headers | None 
    Send extra headers
     None extra_query Query | None 
    Add additional query parameters to the request
     None extra_body Body | None 
    Add additional JSON properties to the request
     None timeout float | Timeout | None | NotGiven 
    Override the client-level default timeout for this request, in seconds
     NOT_GIVEN"},{"location":"ref/data-hub/low-level-api.html#deeporigin_data._client.AsyncDeeporiginData.parse_base_sequence_data","title":"parse_base_sequence_data  async","text":"
    parse_base_sequence_data(\n    *,\n    file_id: str,\n    extra_headers: Headers | None = None,\n    extra_query: Query | None = None,\n    extra_body: Body | None = None,\n    timeout: float | Timeout | None | NotGiven = NOT_GIVEN\n) -> ParseBaseSequenceDataResponse\n
     
    Parses a base sequence file and returns the parsed result.
     
    Parameters:
     Name Type Description Default extra_headers Headers | None 
    Send extra headers
     None extra_query Query | None 
    Add additional query parameters to the request
     None extra_body Body | None 
    Add additional JSON properties to the request
     None timeout float | Timeout | None | NotGiven 
    Override the client-level default timeout for this request, in seconds
     NOT_GIVEN"},{"location":"ref/data-hub/low-level-api.html#deeporigin_data._client.AsyncDeeporiginData.unlock_database","title":"unlock_database  async","text":"
    unlock_database(\n    *,\n    database_id: str,\n    extra_headers: Headers | None = None,\n    extra_query: Query | None = None,\n    extra_body: Body | None = None,\n    timeout: float | Timeout | None | NotGiven = NOT_GIVEN\n) -> UnlockDatabaseResponse\n
     
    An unlocked database can be edited.
     
    Parameters:
     Name Type Description Default extra_headers Headers | None 
    Send extra headers
     None extra_query Query | None 
    Add additional query parameters to the request
     None extra_body Body | None 
    Add additional JSON properties to the request
     None timeout float | Timeout | None | NotGiven 
    Override the client-level default timeout for this request, in seconds
     NOT_GIVEN"},{"location":"ref/data-hub/low-level-api.html#deeporigin_data._client.AsyncDeeporiginData.update_database","title":"update_database  async","text":"
    update_database(\n    *,\n    id: str,\n    database: Database,\n    extra_headers: Headers | None = None,\n    extra_query: Query | None = None,\n    extra_body: Body | None = None,\n    timeout: float | Timeout | None | NotGiven = NOT_GIVEN\n) -> UpdateDatabaseResponse\n
     
    Update a database.
     
    Parameters:
     Name Type Description Default extra_headers Headers | None 
    Send extra headers
     None extra_query Query | None 
    Add additional query parameters to the request
     None extra_body Body | None 
    Add additional JSON properties to the request
     None timeout float | Timeout | None | NotGiven 
    Override the client-level default timeout for this request, in seconds
     NOT_GIVEN"},{"location":"ref/data-hub/low-level-api.html#deeporigin_data._client.AsyncDeeporiginData.update_database_column","title":"update_database_column  async","text":"
    update_database_column(\n    *,\n    column: Column,\n    column_id: str,\n    database_id: str,\n    extra_headers: Headers | None = None,\n    extra_query: Query | None = None,\n    extra_body: Body | None = None,\n    timeout: float | Timeout | None | NotGiven = NOT_GIVEN\n) -> UpdateDatabaseColumnResponse\n
     
    Update a column in a database.
     
    Parameters:
     Name Type Description Default extra_headers Headers | None 
    Send extra headers
     None extra_query Query | None 
    Add additional query parameters to the request
     None extra_body Body | None 
    Add additional JSON properties to the request
     None timeout float | Timeout | None | NotGiven 
    Override the client-level default timeout for this request, in seconds
     NOT_GIVEN"},{"location":"ref/data-hub/low-level-api.html#deeporigin_data._client.AsyncDeeporiginData.update_workspace","title":"update_workspace  async","text":"
    update_workspace(\n    *,\n    id: str,\n    workspace: Workspace,\n    extra_headers: Headers | None = None,\n    extra_query: Query | None = None,\n    extra_body: Body | None = None,\n    timeout: float | Timeout | None | NotGiven = NOT_GIVEN\n) -> UpdateWorkspaceResponse\n
     
    Update a workspace.
     
    Parameters:
     Name Type Description Default extra_headers Headers | None 
    Send extra headers
     None extra_query Query | None 
    Add additional query parameters to the request
     None extra_body Body | None 
    Add additional JSON properties to the request
     None timeout float | Timeout | None | NotGiven 
    Override the client-level default timeout for this request, in seconds
     NOT_GIVEN"},{"location":"ref/data-hub/low-level-api.html#deeporigin_data._client.DeeporiginData","title":"DeeporiginData","text":"
                   Bases: SyncAPIClient
    "},{"location":"ref/data-hub/low-level-api.html#deeporigin_data._client.DeeporiginData.__init__","title":"__init__","text":"
    __init__(\n    *,\n    token: str | None = None,\n    org_id: str | None = None,\n    base_url: str | URL | None = None,\n    timeout: Union[\n        float, Timeout, None, NotGiven\n    ] = NOT_GIVEN,\n    max_retries: int = DEFAULT_MAX_RETRIES,\n    default_headers: Mapping[str, str] | None = None,\n    default_query: Mapping[str, object] | None = None,\n    http_client: Client | None = None,\n    _strict_response_validation: bool = False\n) -> None\n
     
    This automatically infers the following arguments from their corresponding environment variables if they are not provided: - token from ORG_BEARER_TOKEN - org_id from ORG_ID
    "},{"location":"ref/data-hub/low-level-api.html#deeporigin_data._client.DeeporiginData.add_database_column","title":"add_database_column","text":"
    add_database_column(\n    *,\n    column: Column,\n    database_id: str,\n    extra_headers: Headers | None = None,\n    extra_query: Query | None = None,\n    extra_body: Body | None = None,\n    timeout: float | Timeout | None | NotGiven = NOT_GIVEN\n) -> AddDatabaseColumnResponse\n
     
    Add a column to a database.
     
    Parameters:
     Name Type Description Default extra_headers Headers | None 
    Send extra headers
     None extra_query Query | None 
    Add additional query parameters to the request
     None extra_body Body | None 
    Add additional JSON properties to the request
     None timeout float | Timeout | None | NotGiven 
    Override the client-level default timeout for this request, in seconds
     NOT_GIVEN"},{"location":"ref/data-hub/low-level-api.html#deeporigin_data._client.DeeporiginData.archive_files","title":"archive_files","text":"
    archive_files(\n    *,\n    file_ids: List[str],\n    extra_headers: Headers | None = None,\n    extra_query: Query | None = None,\n    extra_body: Body | None = None,\n    timeout: float | Timeout | None | NotGiven = NOT_GIVEN\n) -> object\n
     
    Archive files by their ids.
     
    Parameters:
     Name Type Description Default extra_headers Headers | None 
    Send extra headers
     None extra_query Query | None 
    Add additional query parameters to the request
     None extra_body Body | None 
    Add additional JSON properties to the request
     None timeout float | Timeout | None | NotGiven 
    Override the client-level default timeout for this request, in seconds
     NOT_GIVEN"},{"location":"ref/data-hub/low-level-api.html#deeporigin_data._client.DeeporiginData.chat_create_thread","title":"chat_create_thread","text":"
    chat_create_thread(\n    *,\n    body: object,\n    extra_headers: Headers | None = None,\n    extra_query: Query | None = None,\n    extra_body: Body | None = None,\n    timeout: float | Timeout | None | NotGiven = NOT_GIVEN\n) -> ChatCreateThreadResponse\n
     
    Create a new chat thread.
     
    Parameters:
     Name Type Description Default extra_headers Headers | None 
    Send extra headers
     None extra_query Query | None 
    Add additional query parameters to the request
     None extra_body Body | None 
    Add additional JSON properties to the request
     None timeout float | Timeout | None | NotGiven 
    Override the client-level default timeout for this request, in seconds
     NOT_GIVEN"},{"location":"ref/data-hub/low-level-api.html#deeporigin_data._client.DeeporiginData.chat_list_messages","title":"chat_list_messages","text":"
    chat_list_messages(\n    *,\n    thread_id: str,\n    extra_headers: Headers | None = None,\n    extra_query: Query | None = None,\n    extra_body: Body | None = None,\n    timeout: float | Timeout | None | NotGiven = NOT_GIVEN\n) -> ChatListMessagesResponse\n
     
    List messages in a chat thread.
     
    Parameters:
     Name Type Description Default extra_headers Headers | None 
    Send extra headers
     None extra_query Query | None 
    Add additional query parameters to the request
     None extra_body Body | None 
    Add additional JSON properties to the request
     None timeout float | Timeout | None | NotGiven 
    Override the client-level default timeout for this request, in seconds
     NOT_GIVEN"},{"location":"ref/data-hub/low-level-api.html#deeporigin_data._client.DeeporiginData.chat_send_message","title":"chat_send_message","text":"
    chat_send_message(\n    *,\n    messages: Iterable[Message],\n    thread_id: str,\n    context: Context | NotGiven = NOT_GIVEN,\n    extra_headers: Headers | None = None,\n    extra_query: Query | None = None,\n    extra_body: Body | None = None,\n    timeout: float | Timeout | None | NotGiven = NOT_GIVEN\n) -> None\n
     
    Send a chat message to the Deep Origin assistant and streams results via SSE.
     
    Parameters:
     Name Type Description Default extra_headers Headers | None 
    Send extra headers
     None extra_query Query | None 
    Add additional query parameters to the request
     None extra_body Body | None 
    Add additional JSON properties to the request
     None timeout float | Timeout | None | NotGiven 
    Override the client-level default timeout for this request, in seconds
     NOT_GIVEN"},{"location":"ref/data-hub/low-level-api.html#deeporigin_data._client.DeeporiginData.close","title":"close","text":"
    close() -> None\n
     
    Close the underlying HTTPX client.
     
    The client will not be usable after this.
    "},{"location":"ref/data-hub/low-level-api.html#deeporigin_data._client.DeeporiginData.configure_column_select_options","title":"configure_column_select_options","text":"
    configure_column_select_options(\n    *,\n    column_id: str,\n    database_id: str,\n    option_configuration: Iterable[OptionConfiguration],\n    extra_headers: Headers | None = None,\n    extra_query: Query | None = None,\n    extra_body: Body | None = None,\n    timeout: float | Timeout | None | NotGiven = NOT_GIVEN\n) -> ConfigureColumnSelectOptionsResponse\n
     
    Configure column select options.
     
    Supports both adding and removing options.
     
    Parameters:
     Name Type Description Default extra_headers Headers | None 
    Send extra headers
     None extra_query Query | None 
    Add additional query parameters to the request
     None extra_body Body | None 
    Add additional JSON properties to the request
     None timeout float | Timeout | None | NotGiven 
    Override the client-level default timeout for this request, in seconds
     NOT_GIVEN"},{"location":"ref/data-hub/low-level-api.html#deeporigin_data._client.DeeporiginData.convert_id_format","title":"convert_id_format","text":"
    convert_id_format(\n    *,\n    conversions: Iterable[Conversion],\n    extra_headers: Headers | None = None,\n    extra_query: Query | None = None,\n    extra_body: Body | None = None,\n    timeout: float | Timeout | None | NotGiven = NOT_GIVEN\n) -> ConvertIDFormatResponse\n
     
    Converts between system IDs and human IDs (HIDs).
     
    Parameters:
     Name Type Description Default extra_headers Headers | None 
    Send extra headers
     None extra_query Query | None 
    Add additional query parameters to the request
     None extra_body Body | None 
    Add additional JSON properties to the request
     None timeout float | Timeout | None | NotGiven 
    Override the client-level default timeout for this request, in seconds
     NOT_GIVEN"},{"location":"ref/data-hub/low-level-api.html#deeporigin_data._client.DeeporiginData.copy","title":"copy","text":"
    copy(\n    *,\n    token: str | None = None,\n    org_id: str | None = None,\n    base_url: str | URL | None = None,\n    timeout: float | Timeout | None | NotGiven = NOT_GIVEN,\n    http_client: Client | None = None,\n    max_retries: int | NotGiven = NOT_GIVEN,\n    default_headers: Mapping[str, str] | None = None,\n    set_default_headers: Mapping[str, str] | None = None,\n    default_query: Mapping[str, object] | None = None,\n    set_default_query: Mapping[str, object] | None = None,\n    _extra_kwargs: Mapping[str, Any] = {}\n) -> Self\n
     
    Create a new client instance re-using the same options given to the current client with optional overriding.
    "},{"location":"ref/data-hub/low-level-api.html#deeporigin_data._client.DeeporiginData.create_database","title":"create_database","text":"
    create_database(\n    *,\n    database: Database,\n    extra_headers: Headers | None = None,\n    extra_query: Query | None = None,\n    extra_body: Body | None = None,\n    timeout: float | Timeout | None | NotGiven = NOT_GIVEN\n) -> CreateDatabaseResponse\n
     
    Create a new database.
     
    Parameters:
     Name Type Description Default extra_headers Headers | None 
    Send extra headers
     None extra_query Query | None 
    Add additional query parameters to the request
     None extra_body Body | None 
    Add additional JSON properties to the request
     None timeout float | Timeout | None | NotGiven 
    Override the client-level default timeout for this request, in seconds
     NOT_GIVEN"},{"location":"ref/data-hub/low-level-api.html#deeporigin_data._client.DeeporiginData.create_file_download_url","title":"create_file_download_url","text":"
    create_file_download_url(\n    *,\n    file_id: str,\n    extra_headers: Headers | None = None,\n    extra_query: Query | None = None,\n    extra_body: Body | None = None,\n    timeout: float | Timeout | None | NotGiven = NOT_GIVEN\n) -> CreateFileDownloadURLResponse\n
     
    Returns a pre-signed S3 URL.
     
    Parameters:
     Name Type Description Default file_id str 
    Deep Origin system ID.
     required extra_headers Headers | None 
    Send extra headers
     None extra_query Query | None 
    Add additional query parameters to the request
     None extra_body Body | None 
    Add additional JSON properties to the request
     None timeout float | Timeout | None | NotGiven 
    Override the client-level default timeout for this request, in seconds
     NOT_GIVEN"},{"location":"ref/data-hub/low-level-api.html#deeporigin_data._client.DeeporiginData.create_file_upload","title":"create_file_upload","text":"
    create_file_upload(\n    *,\n    content_length: str,\n    name: str,\n    checksum_sha256: str | NotGiven = NOT_GIVEN,\n    content_type: str | NotGiven = NOT_GIVEN,\n    extra_headers: Headers | None = None,\n    extra_query: Query | None = None,\n    extra_body: Body | None = None,\n    timeout: float | Timeout | None | NotGiven = NOT_GIVEN\n) -> CreateFileUploadResponse\n
     
    Create a file upload URL.
     
    Typically this is creating a pre-signed S3 URL.
     
    Parameters:
     Name Type Description Default checksum_sha256 str | NotGiven 
    Base64 encoded SHA256 checksum of the file.
     NOT_GIVEN extra_headers Headers | None 
    Send extra headers
     None extra_query Query | None 
    Add additional query parameters to the request
     None extra_body Body | None 
    Add additional JSON properties to the request
     None timeout float | Timeout | None | NotGiven 
    Override the client-level default timeout for this request, in seconds
     NOT_GIVEN"},{"location":"ref/data-hub/low-level-api.html#deeporigin_data._client.DeeporiginData.create_workspace","title":"create_workspace","text":"
    create_workspace(\n    *,\n    workspace: Workspace,\n    extra_headers: Headers | None = None,\n    extra_query: Query | None = None,\n    extra_body: Body | None = None,\n    timeout: float | Timeout | None | NotGiven = NOT_GIVEN\n) -> CreateWorkspaceResponse\n
     
    Create a new workspace.
     
    Parameters:
     Name Type Description Default extra_headers Headers | None 
    Send extra headers
     None extra_query Query | None 
    Add additional query parameters to the request
     None extra_body Body | None 
    Add additional JSON properties to the request
     None timeout float | Timeout | None | NotGiven 
    Override the client-level default timeout for this request, in seconds
     NOT_GIVEN"},{"location":"ref/data-hub/low-level-api.html#deeporigin_data._client.DeeporiginData.delete_database","title":"delete_database","text":"
    delete_database(\n    *,\n    database_id: str,\n    extra_headers: Headers | None = None,\n    extra_query: Query | None = None,\n    extra_body: Body | None = None,\n    timeout: float | Timeout | None | NotGiven = NOT_GIVEN\n) -> DeleteDatabaseResponse\n
     
    Permanently deletes a database.
     
    Parameters:
     Name Type Description Default extra_headers Headers | None 
    Send extra headers
     None extra_query Query | None 
    Add additional query parameters to the request
     None extra_body Body | None 
    Add additional JSON properties to the request
     None timeout float | Timeout | None | NotGiven 
    Override the client-level default timeout for this request, in seconds
     NOT_GIVEN"},{"location":"ref/data-hub/low-level-api.html#deeporigin_data._client.DeeporiginData.delete_database_column","title":"delete_database_column","text":"
    delete_database_column(\n    *,\n    column_id: str,\n    database_id: str,\n    extra_headers: Headers | None = None,\n    extra_query: Query | None = None,\n    extra_body: Body | None = None,\n    timeout: float | Timeout | None | NotGiven = NOT_GIVEN\n) -> DeleteDatabaseColumnResponse\n
     
    Delete a column from a database.
     
    Parameters:
     Name Type Description Default extra_headers Headers | None 
    Send extra headers
     None extra_query Query | None 
    Add additional query parameters to the request
     None extra_body Body | None 
    Add additional JSON properties to the request
     None timeout float | Timeout | None | NotGiven 
    Override the client-level default timeout for this request, in seconds
     NOT_GIVEN"},{"location":"ref/data-hub/low-level-api.html#deeporigin_data._client.DeeporiginData.delete_rows","title":"delete_rows","text":"
    delete_rows(\n    *,\n    database_id: str,\n    delete_all: bool | NotGiven = NOT_GIVEN,\n    row_ids: List[str] | NotGiven = NOT_GIVEN,\n    extra_headers: Headers | None = None,\n    extra_query: Query | None = None,\n    extra_body: Body | None = None,\n    timeout: float | Timeout | None | NotGiven = NOT_GIVEN\n) -> DeleteRowsResponse\n
     
    Delete rows by their ids.
     
    Parameters:
     Name Type Description Default delete_all bool | NotGiven 
    When true, deletes all rows in the table except rows with the specified   rowIds.
     NOT_GIVEN row_ids List[str] | NotGiven 
    List of row IDs to delete.
     NOT_GIVEN extra_headers Headers | None 
    Send extra headers
     None extra_query Query | None 
    Add additional query parameters to the request
     None extra_body Body | None 
    Add additional JSON properties to the request
     None timeout float | Timeout | None | NotGiven 
    Override the client-level default timeout for this request, in seconds
     NOT_GIVEN"},{"location":"ref/data-hub/low-level-api.html#deeporigin_data._client.DeeporiginData.delete_workspace","title":"delete_workspace","text":"
    delete_workspace(\n    *,\n    workspace_id: str,\n    extra_headers: Headers | None = None,\n    extra_query: Query | None = None,\n    extra_body: Body | None = None,\n    timeout: float | Timeout | None | NotGiven = NOT_GIVEN\n) -> DeleteWorkspaceResponse\n
     
    Permanently deletes a workspace and all its children.
     
    Parameters:
     Name Type Description Default extra_headers Headers | None 
    Send extra headers
     None extra_query Query | None 
    Add additional query parameters to the request
     None extra_body Body | None 
    Add additional JSON properties to the request
     None timeout float | Timeout | None | NotGiven 
    Override the client-level default timeout for this request, in seconds
     NOT_GIVEN"},{"location":"ref/data-hub/low-level-api.html#deeporigin_data._client.DeeporiginData.describe_code_execution","title":"describe_code_execution","text":"
    describe_code_execution(\n    *,\n    id: str,\n    extra_headers: Headers | None = None,\n    extra_query: Query | None = None,\n    extra_body: Body | None = None,\n    timeout: float | Timeout | None | NotGiven = NOT_GIVEN\n) -> DescribeCodeExecutionResponse\n
     
    Returns information about a particular code execution.
     
    Parameters:
     Name Type Description Default extra_headers Headers | None 
    Send extra headers
     None extra_query Query | None 
    Add additional query parameters to the request
     None extra_body Body | None 
    Add additional JSON properties to the request
     None timeout float | Timeout | None | NotGiven 
    Override the client-level default timeout for this request, in seconds
     NOT_GIVEN"},{"location":"ref/data-hub/low-level-api.html#deeporigin_data._client.DeeporiginData.describe_database","title":"describe_database","text":"
    describe_database(\n    *,\n    database_id: str,\n    extra_headers: Headers | None = None,\n    extra_query: Query | None = None,\n    extra_body: Body | None = None,\n    timeout: float | Timeout | None | NotGiven = NOT_GIVEN\n) -> DescribeDatabaseResponse\n
     
    Describe a database
     
    Parameters:
     Name Type Description Default extra_headers Headers | None 
    Send extra headers
     None extra_query Query | None 
    Add additional query parameters to the request
     None extra_body Body | None 
    Add additional JSON properties to the request
     None timeout float | Timeout | None | NotGiven 
    Override the client-level default timeout for this request, in seconds
     NOT_GIVEN"},{"location":"ref/data-hub/low-level-api.html#deeporigin_data._client.DeeporiginData.describe_database_stats","title":"describe_database_stats","text":"
    describe_database_stats(\n    *,\n    database_id: str,\n    extra_headers: Headers | None = None,\n    extra_query: Query | None = None,\n    extra_body: Body | None = None,\n    timeout: float | Timeout | None | NotGiven = NOT_GIVEN\n) -> DescribeDatabaseStatsResponse\n
     
    Returns aggregation information about a particular database.
     
    Parameters:
     Name Type Description Default extra_headers Headers | None 
    Send extra headers
     None extra_query Query | None 
    Add additional query parameters to the request
     None extra_body Body | None 
    Add additional JSON properties to the request
     None timeout float | Timeout | None | NotGiven 
    Override the client-level default timeout for this request, in seconds
     NOT_GIVEN"},{"location":"ref/data-hub/low-level-api.html#deeporigin_data._client.DeeporiginData.describe_file","title":"describe_file","text":"
    describe_file(\n    *,\n    file_id: str,\n    extra_headers: Headers | None = None,\n    extra_query: Query | None = None,\n    extra_body: Body | None = None,\n    timeout: float | Timeout | None | NotGiven = NOT_GIVEN\n) -> DescribeFileResponse\n
     
    Describe a file by its ID.
     
    Parameters:
     Name Type Description Default file_id str 
    Deep Origin system ID.
     required extra_headers Headers | None 
    Send extra headers
     None extra_query Query | None 
    Add additional query parameters to the request
     None extra_body Body | None 
    Add additional JSON properties to the request
     None timeout float | Timeout | None | NotGiven 
    Override the client-level default timeout for this request, in seconds
     NOT_GIVEN"},{"location":"ref/data-hub/low-level-api.html#deeporigin_data._client.DeeporiginData.describe_row","title":"describe_row","text":"
    describe_row(\n    *,\n    row_id: str,\n    column_selection: (\n        ColumnSelection | NotGiven\n    ) = NOT_GIVEN,\n    fields: bool | NotGiven = NOT_GIVEN,\n    extra_headers: Headers | None = None,\n    extra_query: Query | None = None,\n    extra_body: Body | None = None,\n    timeout: float | Timeout | None | NotGiven = NOT_GIVEN\n) -> DescribeRowResponse\n
     
    Deprecated.
     
    Use DescribeDatabaseRow, DescribeDatabase, or DescribeWorkspace instead.
     
    Parameters:
     Name Type Description Default column_selection ColumnSelection | NotGiven 
    Select columns for inclusion/exclusion.
     NOT_GIVEN extra_headers Headers | None 
    Send extra headers
     None extra_query Query | None 
    Add additional query parameters to the request
     None extra_body Body | None 
    Add additional JSON properties to the request
     None timeout float | Timeout | None | NotGiven 
    Override the client-level default timeout for this request, in seconds
     NOT_GIVEN"},{"location":"ref/data-hub/low-level-api.html#deeporigin_data._client.DeeporiginData.describe_workspace","title":"describe_workspace","text":"
    describe_workspace(\n    *,\n    workspace_id: str,\n    extra_headers: Headers | None = None,\n    extra_query: Query | None = None,\n    extra_body: Body | None = None,\n    timeout: float | Timeout | None | NotGiven = NOT_GIVEN\n) -> DescribeWorkspaceResponse\n
     
    Describe a workspace
     
    Parameters:
     Name Type Description Default extra_headers Headers | None 
    Send extra headers
     None extra_query Query | None 
    Add additional query parameters to the request
     None extra_body Body | None 
    Add additional JSON properties to the request
     None timeout float | Timeout | None | NotGiven 
    Override the client-level default timeout for this request, in seconds
     NOT_GIVEN"},{"location":"ref/data-hub/low-level-api.html#deeporigin_data._client.DeeporiginData.download_file","title":"download_file","text":"
    download_file(\n    *,\n    extra_headers: Headers | None = None,\n    extra_query: Query | None = None,\n    extra_body: Body | None = None,\n    timeout: float | Timeout | None | NotGiven = NOT_GIVEN\n) -> None\n
     
    Returns a 303 redirect to a pre-signed S3 URL.
    "},{"location":"ref/data-hub/low-level-api.html#deeporigin_data._client.DeeporiginData.ensure_rows","title":"ensure_rows","text":"
    ensure_rows(\n    *,\n    database_id: str,\n    rows: Iterable[Row],\n    check_previous_value: bool | NotGiven = NOT_GIVEN,\n    extra_headers: Headers | None = None,\n    extra_query: Query | None = None,\n    extra_body: Body | None = None,\n    timeout: float | Timeout | None | NotGiven = NOT_GIVEN\n) -> EnsureRowsResponse\n
     
    Either creates or updates an existing row.
     
    Supports updates to both system and user defined columns.
     
    Parameters:
     Name Type Description Default extra_headers Headers | None 
    Send extra headers
     None extra_query Query | None 
    Add additional query parameters to the request
     None extra_body Body | None 
    Add additional JSON properties to the request
     None timeout float | Timeout | None | NotGiven 
    Override the client-level default timeout for this request, in seconds
     NOT_GIVEN"},{"location":"ref/data-hub/low-level-api.html#deeporigin_data._client.DeeporiginData.execute_code_async","title":"execute_code_async","text":"
    execute_code_async(\n    *,\n    code: str,\n    code_language: Literal[\"python\"],\n    extra_headers: Headers | None = None,\n    extra_query: Query | None = None,\n    extra_body: Body | None = None,\n    timeout: float | Timeout | None | NotGiven = NOT_GIVEN\n) -> ExecuteCodeAsyncResponse\n
     
    Execute code asynchronously.
     
    Parameters:
     Name Type Description Default extra_headers Headers | None 
    Send extra headers
     None extra_query Query | None 
    Add additional query parameters to the request
     None extra_body Body | None 
    Add additional JSON properties to the request
     None timeout float | Timeout | None | NotGiven 
    Override the client-level default timeout for this request, in seconds
     NOT_GIVEN"},{"location":"ref/data-hub/low-level-api.html#deeporigin_data._client.DeeporiginData.execute_code_sync","title":"execute_code_sync","text":"
    execute_code_sync(\n    *,\n    code: str,\n    code_language: Literal[\"python\"],\n    extra_headers: Headers | None = None,\n    extra_query: Query | None = None,\n    extra_body: Body | None = None,\n    timeout: float | Timeout | None | NotGiven = NOT_GIVEN\n) -> ExecuteCodeSyncResponse\n
     
    Execute code synchronously.
     
    Parameters:
     Name Type Description Default extra_headers Headers | None 
    Send extra headers
     None extra_query Query | None 
    Add additional query parameters to the request
     None extra_body Body | None 
    Add additional JSON properties to the request
     None timeout float | Timeout | None | NotGiven 
    Override the client-level default timeout for this request, in seconds
     NOT_GIVEN"},{"location":"ref/data-hub/low-level-api.html#deeporigin_data._client.DeeporiginData.get_code_execution_result","title":"get_code_execution_result","text":"
    get_code_execution_result(\n    *,\n    id: str,\n    extra_headers: Headers | None = None,\n    extra_query: Query | None = None,\n    extra_body: Body | None = None,\n    timeout: float | Timeout | None | NotGiven = NOT_GIVEN\n) -> object\n
     
    Returns the result of a code execution.
     
    Parameters:
     Name Type Description Default id str 
    Deep Origin system ID.
     required extra_headers Headers | None 
    Send extra headers
     None extra_query Query | None 
    Add additional query parameters to the request
     None extra_body Body | None 
    Add additional JSON properties to the request
     None timeout float | Timeout | None | NotGiven 
    Override the client-level default timeout for this request, in seconds
     NOT_GIVEN"},{"location":"ref/data-hub/low-level-api.html#deeporigin_data._client.DeeporiginData.import_rows","title":"import_rows","text":"
    import_rows(\n    *,\n    database_id: str,\n    add_columns: Iterable[AddColumn] | NotGiven = NOT_GIVEN,\n    creation_block_id: str | NotGiven = NOT_GIVEN,\n    creation_parent_id: str | NotGiven = NOT_GIVEN,\n    extra_headers: Headers | None = None,\n    extra_query: Query | None = None,\n    extra_body: Body | None = None,\n    timeout: float | Timeout | None | NotGiven = NOT_GIVEN\n) -> ImportRowsResponse\n
     
    Creates new rows from CSV data.
     
    Parameters:
     Name Type Description Default add_columns Iterable[AddColumn] | NotGiven 
    Optionally add additional columns to the database during import.
     NOT_GIVEN extra_headers Headers | None 
    Send extra headers
     None extra_query Query | None 
    Add additional query parameters to the request
     None extra_body Body | None 
    Add additional JSON properties to the request
     None timeout float | Timeout | None | NotGiven 
    Override the client-level default timeout for this request, in seconds
     NOT_GIVEN"},{"location":"ref/data-hub/low-level-api.html#deeporigin_data._client.DeeporiginData.list_database_column_unique_values_v2","title":"list_database_column_unique_values_v2","text":"
    list_database_column_unique_values_v2(\n    *,\n    column_id: str,\n    database_id: str,\n    extra_headers: Headers | None = None,\n    extra_query: Query | None = None,\n    extra_body: Body | None = None,\n    timeout: float | Timeout | None | NotGiven = NOT_GIVEN\n) -> ListDatabaseColumnUniqueValuesV2Response\n
     
    Returns the unique values for every cell within the column.
     
    Parameters:
     Name Type Description Default extra_headers Headers | None 
    Send extra headers
     None extra_query Query | None 
    Add additional query parameters to the request
     None extra_body Body | None 
    Add additional JSON properties to the request
     None timeout float | Timeout | None | NotGiven 
    Override the client-level default timeout for this request, in seconds
     NOT_GIVEN"},{"location":"ref/data-hub/low-level-api.html#deeporigin_data._client.DeeporiginData.list_database_rows","title":"list_database_rows","text":"
    list_database_rows(\n    *,\n    database_row_id: str,\n    column_selection: (\n        ColumnSelection | NotGiven\n    ) = NOT_GIVEN,\n    filter: Filter | NotGiven = NOT_GIVEN,\n    limit: int | NotGiven = NOT_GIVEN,\n    offset: int | NotGiven = NOT_GIVEN,\n    row_sort: Iterable[RowSort] | NotGiven = NOT_GIVEN,\n    extra_headers: Headers | None = None,\n    extra_query: Query | None = None,\n    extra_body: Body | None = None,\n    timeout: float | Timeout | None | NotGiven = NOT_GIVEN\n) -> ListDatabaseRowsResponse\n
     
    List database rows with full row data.
     
    Parameters:
     Name Type Description Default column_selection ColumnSelection | NotGiven 
    Select columns for inclusion/exclusion.
     NOT_GIVEN row_sort Iterable[RowSort] | NotGiven 
    Sort rows by column.
     NOT_GIVEN extra_headers Headers | None 
    Send extra headers
     None extra_query Query | None 
    Add additional query parameters to the request
     None extra_body Body | None 
    Add additional JSON properties to the request
     None timeout float | Timeout | None | NotGiven 
    Override the client-level default timeout for this request, in seconds
     NOT_GIVEN"},{"location":"ref/data-hub/low-level-api.html#deeporigin_data._client.DeeporiginData.list_files","title":"list_files","text":"
    list_files(\n    *,\n    filters: Iterable[Filter] | NotGiven = NOT_GIVEN,\n    extra_headers: Headers | None = None,\n    extra_query: Query | None = None,\n    extra_body: Body | None = None,\n    timeout: float | Timeout | None | NotGiven = NOT_GIVEN\n) -> ListFilesResponse\n
     
    Returns a list of files using the filters.
     
    Parameters:
     Name Type Description Default extra_headers Headers | None 
    Send extra headers
     None extra_query Query | None 
    Add additional query parameters to the request
     None extra_body Body | None 
    Add additional JSON properties to the request
     None timeout float | Timeout | None | NotGiven 
    Override the client-level default timeout for this request, in seconds
     NOT_GIVEN"},{"location":"ref/data-hub/low-level-api.html#deeporigin_data._client.DeeporiginData.list_mentions","title":"list_mentions","text":"
    list_mentions(\n    *,\n    query: str,\n    extra_headers: Headers | None = None,\n    extra_query: Query | None = None,\n    extra_body: Body | None = None,\n    timeout: float | Timeout | None | NotGiven = NOT_GIVEN\n) -> ListMentionsResponse\n
     
    Returns entities that can be mentioned in a notebook.
     
    Parameters:
     Name Type Description Default extra_headers Headers | None 
    Send extra headers
     None extra_query Query | None 
    Add additional query parameters to the request
     None extra_body Body | None 
    Add additional JSON properties to the request
     None timeout float | Timeout | None | NotGiven 
    Override the client-level default timeout for this request, in seconds
     NOT_GIVEN"},{"location":"ref/data-hub/low-level-api.html#deeporigin_data._client.DeeporiginData.list_row_back_references","title":"list_row_back_references","text":"
    list_row_back_references(\n    *,\n    database_id: str,\n    row_id: str,\n    extra_headers: Headers | None = None,\n    extra_query: Query | None = None,\n    extra_body: Body | None = None,\n    timeout: float | Timeout | None | NotGiven = NOT_GIVEN\n) -> ListRowBackReferencesResponse\n
     
    Finds all the places a row is referenced.
     
    Parameters:
     Name Type Description Default extra_headers Headers | None 
    Send extra headers
     None extra_query Query | None 
    Add additional query parameters to the request
     None extra_body Body | None 
    Add additional JSON properties to the request
     None timeout float | Timeout | None | NotGiven 
    Override the client-level default timeout for this request, in seconds
     NOT_GIVEN"},{"location":"ref/data-hub/low-level-api.html#deeporigin_data._client.DeeporiginData.list_rows","title":"list_rows","text":"
    list_rows(\n    *,\n    filters: Iterable[Filter],\n    extra_headers: Headers | None = None,\n    extra_query: Query | None = None,\n    extra_body: Body | None = None,\n    timeout: float | Timeout | None | NotGiven = NOT_GIVEN\n) -> ListRowsResponse\n
     
    Lists rows at a given depth in the hierarchy.
     
    Parameters:
     Name Type Description Default extra_headers Headers | None 
    Send extra headers
     None extra_query Query | None 
    Add additional query parameters to the request
     None extra_body Body | None 
    Add additional JSON properties to the request
     None timeout float | Timeout | None | NotGiven 
    Override the client-level default timeout for this request, in seconds
     NOT_GIVEN"},{"location":"ref/data-hub/low-level-api.html#deeporigin_data._client.DeeporiginData.lock_database","title":"lock_database","text":"
    lock_database(\n    *,\n    database_id: str,\n    extra_headers: Headers | None = None,\n    extra_query: Query | None = None,\n    extra_body: Body | None = None,\n    timeout: float | Timeout | None | NotGiven = NOT_GIVEN\n) -> LockDatabaseResponse\n
     
    A locked database cannot be edited.
     
    Parameters:
     Name Type Description Default extra_headers Headers | None 
    Send extra headers
     None extra_query Query | None 
    Add additional query parameters to the request
     None extra_body Body | None 
    Add additional JSON properties to the request
     None timeout float | Timeout | None | NotGiven 
    Override the client-level default timeout for this request, in seconds
     NOT_GIVEN"},{"location":"ref/data-hub/low-level-api.html#deeporigin_data._client.DeeporiginData.parse_base_sequence_data","title":"parse_base_sequence_data","text":"
    parse_base_sequence_data(\n    *,\n    file_id: str,\n    extra_headers: Headers | None = None,\n    extra_query: Query | None = None,\n    extra_body: Body | None = None,\n    timeout: float | Timeout | None | NotGiven = NOT_GIVEN\n) -> ParseBaseSequenceDataResponse\n
     
    Parses a base sequence file and returns the parsed result.
     
    Parameters:
     Name Type Description Default extra_headers Headers | None 
    Send extra headers
     None extra_query Query | None 
    Add additional query parameters to the request
     None extra_body Body | None 
    Add additional JSON properties to the request
     None timeout float | Timeout | None | NotGiven 
    Override the client-level default timeout for this request, in seconds
     NOT_GIVEN"},{"location":"ref/data-hub/low-level-api.html#deeporigin_data._client.DeeporiginData.unlock_database","title":"unlock_database","text":"
    unlock_database(\n    *,\n    database_id: str,\n    extra_headers: Headers | None = None,\n    extra_query: Query | None = None,\n    extra_body: Body | None = None,\n    timeout: float | Timeout | None | NotGiven = NOT_GIVEN\n) -> UnlockDatabaseResponse\n
     
    An unlocked database can be edited.
     
    Parameters:
     Name Type Description Default extra_headers Headers | None 
    Send extra headers
     None extra_query Query | None 
    Add additional query parameters to the request
     None extra_body Body | None 
    Add additional JSON properties to the request
     None timeout float | Timeout | None | NotGiven 
    Override the client-level default timeout for this request, in seconds
     NOT_GIVEN"},{"location":"ref/data-hub/low-level-api.html#deeporigin_data._client.DeeporiginData.update_database","title":"update_database","text":"
    update_database(\n    *,\n    id: str,\n    database: Database,\n    extra_headers: Headers | None = None,\n    extra_query: Query | None = None,\n    extra_body: Body | None = None,\n    timeout: float | Timeout | None | NotGiven = NOT_GIVEN\n) -> UpdateDatabaseResponse\n
     
    Update a database.
     
    Parameters:
     Name Type Description Default extra_headers Headers | None 
    Send extra headers
     None extra_query Query | None 
    Add additional query parameters to the request
     None extra_body Body | None 
    Add additional JSON properties to the request
     None timeout float | Timeout | None | NotGiven 
    Override the client-level default timeout for this request, in seconds
     NOT_GIVEN"},{"location":"ref/data-hub/low-level-api.html#deeporigin_data._client.DeeporiginData.update_database_column","title":"update_database_column","text":"
    update_database_column(\n    *,\n    column: Column,\n    column_id: str,\n    database_id: str,\n    extra_headers: Headers | None = None,\n    extra_query: Query | None = None,\n    extra_body: Body | None = None,\n    timeout: float | Timeout | None | NotGiven = NOT_GIVEN\n) -> UpdateDatabaseColumnResponse\n
     
    Update a column in a database.
     
    Parameters:
     Name Type Description Default extra_headers Headers | None 
    Send extra headers
     None extra_query Query | None 
    Add additional query parameters to the request
     None extra_body Body | None 
    Add additional JSON properties to the request
     None timeout float | Timeout | None | NotGiven 
    Override the client-level default timeout for this request, in seconds
     NOT_GIVEN"},{"location":"ref/data-hub/low-level-api.html#deeporigin_data._client.DeeporiginData.update_workspace","title":"update_workspace","text":"
    update_workspace(\n    *,\n    id: str,\n    workspace: Workspace,\n    extra_headers: Headers | None = None,\n    extra_query: Query | None = None,\n    extra_body: Body | None = None,\n    timeout: float | Timeout | None | NotGiven = NOT_GIVEN\n) -> UpdateWorkspaceResponse\n
     
    Update a workspace.
     
    Parameters:
     Name Type Description Default extra_headers Headers | None 
    Send extra headers
     None extra_query Query | None 
    Add additional query parameters to the request
     None extra_body Body | None 
    Add additional JSON properties to the request
     None timeout float | Timeout | None | NotGiven 
    Override the client-level default timeout for this request, in seconds
     NOT_GIVEN"},{"location":"ref/data-hub/types.html","title":"Classes and constants","text":"
    This page lists some classes, types and constants used in this library.
    "},{"location":"ref/data-hub/types.html#src.data_hub.dataframe.DataFrame","title":"src.data_hub.dataframe.DataFrame","text":"
                   Bases: DataFrame
     
    A subclass of pandas DataFrame that allows for easy updating of a Deep Origin database. This can be used as a drop-in replacement for a pandas DataFrame, and should support all methods a pandas DataFrame supports.
     
    The primary method of creating an object of this type is to use the from_deeporigin class method.
    "},{"location":"ref/data-hub/types.html#src.data_hub.dataframe.DataFrame.auto_sync","title":"auto_sync  class-attribute instance-attribute","text":"
    auto_sync: bool = False\n
     
    When True, changes made to the dataframe will be automatically synced to the Deep Origin database this dataframe represents.
    "},{"location":"ref/data-hub/types.html#src.data_hub.dataframe.DataFrame.from_deeporigin","title":"from_deeporigin  classmethod","text":"
    from_deeporigin(\n    database_id: str,\n    *,\n    use_file_names: bool = True,\n    reference_format: IDFormat = \"human-id\",\n    filter: Optional[dict] = None,\n    client=None\n)\n
     
    Create a local Deep Origin DataFrame from a Deep Origin database.
     
    Parameters:
     Name Type Description Default database_id str 
    The ID of the Deep Origin database.
     required use_file_names bool 
    Whether to use the file names in the Deep Origin database. Defaults to True.
     True reference_format IDFormat 
    The format of the IDs in the Deep Origin database. Defaults to \"human-id\".
     'human-id'"},{"location":"ref/data-hub/types.html#src.data_hub.dataframe.DataFrame.to_deeporigin","title":"to_deeporigin","text":"
    to_deeporigin()\n
     
    Write data in dataframe to Deep Origin
     
    Deep Origin DataFrames can automatically synchronize
     
    To automatically save changes to local DataFrames to Deep Origin databases, set the auto_sync attribute of the dataframe True.
    "},{"location":"ref/data-hub/types.html#src.utils.constants","title":"src.utils.constants","text":"
    this module contains constants used in the rest of this library
    "},{"location":"ref/data-hub/types.html#src.utils.constants.Cardinality","title":"Cardinality  module-attribute","text":"
    Cardinality = Literal['one', 'many']\n
     
    The cardinality defines whether a cell in a database can contain one or multiple objects
    "},{"location":"ref/data-hub/types.html#src.utils.constants.DataType","title":"DataType  module-attribute","text":"
    DataType = Literal[\n    \"integer\",\n    \"select\",\n    \"date\",\n    \"text\",\n    \"file\",\n    \"reference\",\n    \"editor\",\n    \"float\",\n    \"boolean\",\n]\n
     
    Type of a column in a Deep Origin database. See this page in the documentation for more information.
    "},{"location":"ref/data-hub/types.html#src.utils.constants.DatabaseReturnType","title":"DatabaseReturnType  module-attribute","text":"
    DatabaseReturnType = Literal['dataframe', 'dict']\n
     
    Return type for api.get_dataframe
    "},{"location":"ref/data-hub/types.html#src.utils.constants.FileStatus","title":"FileStatus  module-attribute","text":"
    FileStatus = Literal['ready', 'archived']\n
     
    Status of a file. Ready files are ready to be used, downloaded, and operated on.
    "},{"location":"ref/data-hub/types.html#src.utils.constants.IDFormat","title":"IDFormat  module-attribute","text":"
    IDFormat = Literal['human-id', 'system-id']\n
     
    Format of an ID
    "},{"location":"ref/data-hub/types.html#src.utils.constants.ObjectType","title":"ObjectType  module-attribute","text":"
    ObjectType = Literal['row', 'database', 'workspace']\n
     
    Type of a row. In Deep Origin, a row can be a database row, a database or a workspace
    "},{"location":"ref/data-hub/types.html#src.utils.constants.PREFIXES","title":"PREFIXES  dataclass","text":"
    Prefixes for CLI and Python client
    "}]}
\ No newline at end of file
+{"config":{"lang":["en"],"separator":"[\\s\\-]+","pipeline":["stopWordFilter"]},"docs":[{"location":"index.html","title":"Deep Origin CLI and Python client","text":"
       
    •  Access Deep Origin resources Work with your Deep Origin data, variables, secrets, and other resources through a CLI or Python.
      •  
    •  Free and open-source Install onto your computer to use your data, variables, secrets, and other resources outside Deep Origin.
      •  
    •  Easy to install Just run pip install deeporigin.
      •  
    •  Pure Python Lightweight, written in pure Python. Works on any system that can run Python.
      •  
    "},{"location":"index.html#examples","title":"Examples","text":"
    The Deep Origin CLI and Python client allow you to programmatically interact with the Deep Origin OS . The example below illustrates how to use the CLI and Python library to retrieve the database row with ID data-1.
     TerminalPython 
    deeporigin data show data-1\n\n\u256d\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u252c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u256e\n\u2502 Column      \u2502 Value                        \u2502\n\u251c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u253c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2524\n\u2502 Boolean     \u2502 False                        \u2502\n\u2502 Float       \u2502 112                          \u2502\n\u2502 Select      \u2502 sdsd                         \u2502\n\u2502 Date        \u2502 2024-06-19 00:00:00          \u2502\n\u2502 File        \u2502 _file:hnU7F62xeW8j0l1kR7YP1  \u2502\n\u2570\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2534\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u256f\n
     
    from deeporigin.data_hub import api\n\napi.get_row_data(\"data-1\")\n\n# {'Status': 'Processing',\n#  'Age (years)': 15,\n#  'Gender': 'F',\n#  'Order date': '2024-03-01T00:00:00',\n#  'Received by client': '2023-04-05T00:00:00',\n#  'Sent to client': '2024-03-03T00:00:00',\n#  'Sent by client': '2024-03-05T00:00:00',\n#  'Raw reads': ['_file:UjKrB0QibhgBDAVvGQ3VP'],\n#  'Date completed': '2024-03-08T00:00:00',\n# }\n
    "},{"location":"changelog.html","title":"Changelog","text":""},{"location":"changelog.html#deeporigin-v300","title":"deeporigin v3.0.0","text":"
    Breaking changes
     
    This release is a breaking change. Responses to all functions are no longer objects, but are now dictionaries wrapped in python Boxes. 
    "},{"location":"changelog.html#bugfixes","title":"Bugfixes","text":"
       
    • Fixed a bug where writing more than 1000 rows failed
      •  
    • Fixed a bug where constructing a dataframe from an empty DB failed
      •  
    "},{"location":"changelog.html#new-features","title":"New features","text":"
       
    • Ability to add new data to existing dataframes
      •  
    • Support for Deep Origin platform SDK
      •  
    • Deep Origin dataframes now disallow adding rows
      •  
    • Better support for writing data back to databases
      •  
    "},{"location":"changelog.html#miscellaneous","title":"Miscellaneous","text":"
       
    • Initial support for integration tests with Deep Origin Data Hub
      •  
    • Large refactor of testing
      •  
    "},{"location":"changelog.html#deeporigin-v240","title":"deeporigin v2.4.0","text":""},{"location":"changelog.html#bugfixes_1","title":"Bugfixes","text":"
       
    • fixed a bug in how tokens were refreshed
      •  
    • fixed a bug in CLI config use
      •  
    "},{"location":"changelog.html#new-features_1","title":"New features","text":"
       
    • added the ability to download files in parallel
      •  
    • added ability to upload files with file hashes 
      •  
    • added the ability to decode user tokens
      •  
    • support for a async client for the Deep Origin Data Hub API
      •  
    • reference IDs now tracked in dataframes 
      •  
    • dataframes now support expressions and users 
      •  
    • dataframe slicing now restricts addition of new rows to slice
      •  
    • dataframe updates more atomic: a single cell change only triggers updating that cell
      •  
    • ability to delete terminated workstations 
      •  
    • package wide ability to check for latest versions on PyPI
      •  
    "},{"location":"changelog.html#miscellaneous_1","title":"Miscellaneous","text":"
       
    • testing now includes python 3.13
      •  
    • Data Hub API route now set to datahub-api/api/
      •  
    • improved test coverage
      •  
    "},{"location":"changelog.html#deeporigin-v221","title":"deeporigin v2.2.1","text":"
       
    • added the ability to interact with the platform, including
         
      • fetching user secrets from the platform
        •  
      • fetching user info from the platform
        •  
      • fetching workstation info from the platform
        •  
       
      •  
    • removed support for graphQL endpoints for secrets and variables
      •  
    • support for new (breaking) syntax for deleting databases, folders, rows, and columns
      •  
    • better support for caching tokens in filesystem
      •  
    • numerous bug fixes and small improvements
      •  
    • dropped support for Python 3.9
      •  
    • better syntax for interacting with the api.list_files function
      •  
    • Improvements to Deep Origin DataFrames, including:
         
      • ability to create new columns in dataframes and push them to a database
        •  
      • DataFrames now show names of user who created and last updated a database, not just a ID
        •  
      • DataFrame pretty printing methods now never interrupt core logic, and fall back to printing methods of superclass on failure
        •  
      • DataFrames now support df.tail() and df.head()
        •  
       
      •  
    "},{"location":"changelog.html#deeporigin-v211","title":"deeporigin v2.1.1","text":"
       
    • fixed a bug where dataframe header links were sometimes broken
      •  
    • improved display of dataframe headers
      •  
    • improved typing in dataframes
      •  
    • added ability to check for newest versions on PyPI
      •  
    • version numbers are now PEP 440 compliant
      •  
    "},{"location":"changelog.html#deeporigin-v210","title":"deeporigin v2.1.0","text":"
       
    • dropped support for column keys
      •  
    • added the deeporigin.DataFrame class, which:
         
      • is a drop-in replacement for pandas.DataFrame
        •  
      • supports all pandas methods
        •  
      • supports automatic syncing with a Deep Origin database
        •  
       
      •  
    "},{"location":"configure.html","title":"Configuration","text":""},{"location":"configure.html#on-a-deep-origin-workstation","title":"On a Deep Origin workstation","text":"
    On a Deep Origin workstation, no configuration is needed! Within a workstation, the Deep Origin CLI and Python client are automatically configured.
    "},{"location":"configure.html#on-your-local-computer","title":"On your local computer","text":"
    To run this package outside of a Deep Origin workstation (for example, on your own computer), first you need to configure this package. After installing this package, run the following to configure your organization, replacing org-id with the ID of the Deep Origin organization that you would like to work with.
     
    deeporigin config set organization_id [org-id]\n
    "},{"location":"configure.html#view-configuration","title":"View configuration","text":"
    To view the configuration for this package, run:
     
    deeporigin config show\n
     
    This will display a table such as below:
     
    \u256d\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u252c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u256e\n\u2502 Variable                    \u2502 Value                               \u2502\n\u251c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u253c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2524\n\u2502 organization_id             \u2502 likely-aardvark-ewo                 \u2502\n\u2502 bench_id                    \u2502 average-possum-3x3                  \u2502\n\u2502 env                         \u2502 us-west-1                           \u2502\n\u2502 api_endpoint                \u2502 https://os.prod.deeporigin.io/api   \u2502\n\u2502 nucleus_api_route           \u2502 datahub-api/api/                    \u2502\n\u2502 auth_domain                 \u2502 https://formicbio-dev.us.auth0.com  \u2502\n\u2502 auth_device_code_endpoint   \u2502 oauth/device/code/                  \u2502\n\u2502 auth_token_endpoint         \u2502 oauth/token/                        \u2502\n\u2502 auth_audience               \u2502 https://os.deeporigin.io/api        \u2502\n\u2502 auth_grant_type             \u2502 urn:ietf:params:device_code         \u2502\n\u2502 auth_client_id              \u2502 <secret>                            \u2502\n\u2502 auth_client_secret          \u2502 <secret>                            \u2502\n\u2502 variables_cache_filename    \u2502 ~/variables.yml                     \u2502\n\u2502 feature_flags               \u2502                                     \u2502\n\u2570\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2534\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u256f\n
    "},{"location":"configure.html#set-a-configuration-variable","title":"Set a configuration variable","text":"
    To set a variable, run:
     
    deeporigin config set [variable-name] [variable-value]\n
     
    For example, to configure your organization, run:
     
    deeporigin config set organization_id likely-aardvark-ewo\n
    "},{"location":"install.html","title":"Installation","text":""},{"location":"install.html#on-a-deep-origin-workstation","title":"On a Deep Origin workstation","text":"
    No installation needed!
     
    The Deep Origin CLI and Python client are installed on every workstation.
    "},{"location":"install.html#on-your-local-computer","title":"On your local computer","text":"
    Run the command below for your favorite package manager to install the Deep Origin CLI and Python client.
     pippixipipxpipenvpoetryuvflit 
    pip install deeporigin\n
     
    pixi add --pypi deeporigin\n
     
    pipx install deeporigin\n
     
    pipenv install deeporigin\n
     
    poetry add deeporigin\n
     
    uv pip install deeporigin\n
     
    flit install deeporigin\n
    "},{"location":"install.html#for-developers","title":"For developers","text":"
    Developers only
     
    If you intend to contribute this package, we recommend installing this package via the instructions below. If you simply intend to use this package, we recommend following the instructions above.
    "},{"location":"install.html#get-the-code","title":"Get the code","text":"
    First, run the following command to clone the source code repository:
     
    git clone git@github.com:deeporiginbio/deeporigin-client.git\n
    "},{"location":"install.html#install-the-development-dependencies-for-this-package","title":"Install the development dependencies for this package","text":"
    Second, install Python 3.9+ and make.
     
    To verify that both are installed, run the following commands:
     
    python3 --version\n# Python 3.12.3\n\nmake --version\n# GNU Make 4.4.1\n
    "},{"location":"install.html#create-an-editable-installation-of-this-package-from-the-cloned-source-code","title":"Create an editable installation of this package from the cloned source code","text":"
    Third, navigate to the directory you cloned the code to, and run the following command:
     
    make install\n
     
    This will install this package in an \"editable\" mode. In this mode, changes to the source code will take effect immediately.
    "},{"location":"install.html#run-the-linting-and-tests-for-this-package","title":"Run the linting and tests for this package","text":"
    Once installed, you can lint and test this package by running the following commands:
     
    make lint\nmake test\n
    "},{"location":"install.html#compiling-and-serving-the-documentation-for-this-package","title":"Compiling and serving the documentation for this package","text":"
    You can compile and serve the documentation for this package by running:
     
    make docs-serve\n
    "},{"location":"install.html#supported-python-versions","title":"Supported Python versions","text":"
    deeporigin is tested against the following versions of Python in Ubuntu Linux and Windows:
     
       
    • 3.10
      •  
    • 3.11
      •  
    • 3.12
      •  
    • 3.13
      •  
    "},{"location":"compute-hub/index.html","title":"Compute hub","text":"
    The Deep Origin compute hub allows you create and use powerful workstations with pre-installed software packages. Deep Origin was built to help computational scientists get clean data from their labs and perform advanced analyses and simulations.
     
    Each Deep Origin workstation comes pre-installed and pre-configured with this Python client and CLI.
     
    Learn more about the compute hub here .
    "},{"location":"data-hub/index.html","title":"Data hub","text":"
    The Deep Origin data hub provides R&D teams a foundation for collaboratively capturing data, extracting insights, and making decisions:
     
       
    • Databases for capturing rows of data, metadata, and procedures.
      •  
    • Customizable columns for capturing structured information such as the age and genotype of a sample.
      •  
    • Notebooks such as for common protocols and recording experiments.
      •  
    • File columns and notebook attachments for capturing files such as the results of experiments.
      •  
    • Reference columns and notebook mentions for capturing relationships, such as the chemical, RNA, antibody, or cell line that an assay characterized.
      •  
    • Folders for hierarchically organizing data, such as by project, team, or experimental modality.
      •  
    • Column and file viewers such as for visualizing the sequence of a plasmid or the structure of a chemical or protein.
      •  
    • Chart studio for interactively analyzing columnar data.
      •  
    • AI assistant for interactively analyze and visualize data.
      •  
    • Process flows and automations for streamlining data processing, decision-making, and project management.
      •  
     
    Learn more about the data hub here .
    "},{"location":"data-hub/dataframes.html","title":"Using Deep Origin DataFrames","text":"
    This page describes how to a Deep Origin DataFrame, which are the primary object you will use to interact with a database on Deep Origin. This page will cover:
     
       
    • fetching data from a Deep Origin database
      •  
    • modifying data locally
      •  
    • writing data back to Deep Origin
      •  
     
    What is a Deep Origin DataFrame?
     
    A Deep Origin DataFrame is a subclass of a pandas.DataFrame that is created from a Deep Origin database, and can easily write data back to it. Because it is a subclass of a pandas DataFrame, all pandas DataFrame methods work on Deep Origin DataFrames. 
    "},{"location":"data-hub/dataframes.html#create-a-dataframe","title":"Create a DataFrame","text":"
    Create a DataFrame using:
     
    from deeporigin.data_hub.dataframe import DataFrame\ndf = DataFrame.from_deeporigin(\"database-id\")\n
     
    In a Jupyter Lab, you should be able to view the DataFrame using:
     
    df\n
     
    which should show you something like this:
     
     
    Information in the DataFrame
     
    In addition to information you would find in the rows and columns of a pandas DataFrame, a Deep Origin DataFrame also contains metadata about the underlying database. In the view above we also see:
     
       
    • The name of the database on Deep Origin.
      •  
    • A link to the database on Deep Origin.
      •  
    • When the database was created.
      •  
    • Information about the last edit made to the database. 
      •  
     
    Fetching only some rows
     
    If you have a particularly large database, you may want to fetch only certain rows using a filter. For example, to fetch only rows where column x is greater than 42:
     
    ```python from deeporigin.data_hub import filters filter = filters.filter(     column_id=\"x\", # can be name or column     filter_value=42,     operator=\"greaterThan\",     filter_type=\"number\", ) df = DataFrame.from_deeporigin(\"your-db-id\",   filter=filter) df
     
    ```
    "},{"location":"data-hub/dataframes.html#modify-data-in-the-dataframe","title":"Modify data in the DataFrame","text":"
    Because a Deep Origin DataFrame is a subclass of a pandas DataFrame, all pandas DataFrame methods work on Deep Origin DataFrames. In this example, we modify values in one of the columns, or modify a single cell.
     Modify entire columnsModify data in a single cell 
    To modify entire columns, use native pandas syntax:
     
    df[\"y^2\"] = df[\"y\"] ** 2\n
     
    To modify data in a single cell, use native pandas syntax (the at operator):
     
    df.at[\"sgs-1\", \"y\"] = 10\n
     
    In either case, when we view the DataFrame once more using df, we see the updated data, together with a warning telling us that we have local changes that haven't been written back to Deep Origin.
     
    "},{"location":"data-hub/dataframes.html#write-data-back-to-deep-origin","title":"Write data back to Deep Origin","text":"
    Work in progress
     
    Writing data back to Deep Origin from a Deep Origin DataFrame is still a work in progress. The following functionality is not yet supported. To perform these functions, use the API directly instead. 
     
       
    • Updating values of cells that contain files
      •  
    • Updating values of cells that contain references
      •  
    • Uploading files
      •  
    • Modifying or deleting existing columns. To delete a column, use the GUI or the API and then use the from_deeporigin method.
      •  
    • Creating new columns. To insert data into a new column, create a new column using the GUI or the API and then use the from_deeporigin method.
      •  
    • Deleting rows
      •  
    • Creating new databases
      •  
    "},{"location":"data-hub/dataframes.html#using-the-to_deeporigin-method","title":"Using the to_deeporigin method","text":"
    Local changes in the dataframe can be written back to Deep Origin using the to_deeporigin method:
     
    df.to_deeporigin()\n\n# \u2714\ufe0e Wrote 9 rows in y^2 to Deep Origin database.\n
     
    The to_deeporigin method writes data that have been modified in the local dataframe back to the corresponding Deep Origin Database. 
     
    Intelligent writing
     
       
    • Deep Origin DataFrames keep track of local changes, and only write columns back that have been modified locally. 
      •  
    • Every call of to_deeporigin will generate a print statement describing the changes that have been written back to Deep Origin. 
      •  
    • Because a Deep Origin DataFrame corresponds to a database on Deep Origin, there is no need to specify the database name in the to_deeporigin method.
      •  
     
    If we now view the dataframe once more using df, we see the following:
     
     
    Note that the warning about local changes that have not been written back to Deep Origin has disappeared, because the changes have been written back to Deep Origin.
    "},{"location":"data-hub/dataframes.html#automatic-writing-to-deep-origin","title":"Automatic writing to Deep Origin","text":"
    All Deep Origin DataFrames have an attribute called auto_sync that determines if local changes are written automatically to Deep Origin. By default, auto_sync is set to False, requiring you to call the to_deeporigin method to write changes back to Deep Origin.
     
    To enable automatic syncing, set the auto_sync attribute to True:
     
    df.auto_sync = True\ndf\n
     
     
    Note that the dataframe now displays a message indicating that local changes will be written back to Deep Origin.
     
    Making any change to the dataframe now triggers a write back to the Deep Origin database.
     
    df[\"y^2\"] = df[\"y\"] * 0.99\ndf\n\n# \u2714\ufe0e Wrote 9 rows in y^2 to Deep Origin database.\n
     
    Use auto_sync with caution
     
    Turning on auto_sync on dataframes can be dangerous.  - Changes made to the local database are written to a Deep Origin database automatically, and no confirmation is asked for.  - This can cause data loss. - Every change made to the database is written immediately, so modifying the local dataframe multiple times leads to multiple writes to a Deep Origin database.
    "},{"location":"data-hub/dataframes.html#reference","title":"Reference","text":"
    Read more about the to_deeporigin method here. 
    "},{"location":"how-to/auth.html","title":"Sign into Deep Origin","text":"
    Configure if running locally
     
    If you're running this code on your local computer (outside of a Deep Origin Workstation), make sure to configure it first.
     
    To use most of the functionality of the CLI or Python client, you must first run one of the following commands to sign into Deep Origin.
     CLIPython 
    deeporigin authenticate\n
     
    from deeporigin import auth\nauth.authenticate()\n
     
    In either case, you will be presented with a prompt similar to below:
     
    To connect to the Deep Origin OS, navigate your browser to \n\nhttps://<env>auth0.com/activate?user_code=VMPZ-PQFG\n\nand verify the confirmation code is \"VMPZ-PQFG\", and click the \"Confirm\" button.\n
     
    When you visit that URL, you will see a prompt that looks like:
     
     
    After clicking the Confirm button, you will see a confirmation similar to below:
     
     
    After signing in, your access tokens will be cached to disk and then automatically be used in subsequent interactions with Deep Origin.
     
    Authenticating
     
    In most cases, you only need to authenticate to the Deep Origin OS once. You do not need to authenticate every time you use the client or the CLI.
     
    Authenticating on Deep Origin workstations
     
    Presently, workstation users must authenticate (once) to the Deep Origin OS. We plan to develop the capability to automatically authenticate workstation users.
    "},{"location":"how-to/compute-hub/variables.html","title":"Install variables and secrets","text":"
    Variables and secrets captured in the Deep Orgin OS, either at the organization level or the account level, can be installed into workstations by running the following command:
     
    deeporigin variables install\n
     
    This command will install your variables and secrets into your workstation and print a message similar to that below:
     
    No variables were modified\nNo variables were added\nNo variables were deleted\n1 variables were unmodified:\n  EnvironmentVariable: foo\n
     
    Only on Deep Origin workstations
     
    This function of the CLI only works on Deep Origin workstations. This function will not work on your local computer.
    "},{"location":"how-to/compute-hub/workstation-info.html","title":"Get information about your Deep Origin workstation","text":"
    Inside a Deep Origin workstation, run the following command to get information about the workstation:
     
    deeporigin context\n
     
    This will display a table similar to below:
     
    Workstation ID: average-possum-3x3\nUser ID: None\nOrganization ID: likely-aardvark-ewo\nEnvironment: edge\nDebug: False\n
     
    Only supported on Deep Origin workstations
     
    Note that this command is only supported on Deep Origin workstations. If you run this command outside of a workstation, you will likely see this output:
     
    Workstation ID: None\nUser ID: None\nOrganization ID: None\nEnvironment: None\nDebug: False\n
    "},{"location":"how-to/data-hub/add-data.html","title":"Add data to a Deep Origin Database","text":"
    This document describes how to add data to a Deep Origin Database.
     
    Consider the following dataframe constructed from a database using:
     
    from deeporigin.data_hub import api\ndf = api.get_dataframe(\"xy\")\ndf\n
     
    "},{"location":"how-to/data-hub/add-data.html#add-new-rows","title":"Add new rows","text":"
    To add new rows to the underlying database, use the add_databse_rows function:
     
    data = dict(X=[1, 2], Y=[2, 3])\napi.add_database_rows(database_id=\"xy\", data=data)\n
     
    data should be a dictionary where the keys are column names and the values are lists of values to be written to the corresponding columns. add_database_rows will add this data to the database, creating as many new rows as needed. 
     
    add_database_rows returns a list of the row IDs created during this process.
    "},{"location":"how-to/data-hub/add-data.html#add-fragments-of-new-rows","title":"Add fragments of new rows","text":"
    Similarly, fragments of rows (subsets of columns) can be written to the database:
     
    data = dict(X=[10, 20]) # note Y is not specified\napi.add_database_rows(database_id=\"xy\", data=data)\n
     
    add_database_rows returns a list of the row IDs created during this process, for example:
     
    [\"row-1\", \"row-2\"]\n
    "},{"location":"how-to/data-hub/add-data.html#reference","title":"Reference","text":"
    The reference documentation for add_database_rows
    "},{"location":"how-to/data-hub/create.html","title":"Create objects","text":"
    This document describes how to create databases, columns in databases, and folders (workspaces) in the Deep Origin data hub.
    "},{"location":"how-to/data-hub/create.html#folders","title":"Folders","text":"
    Folders can be created by specifying a name, and, optionally, a parent.
     CLIPython 
    If no parent is specified, the folder will be created at the root level.
     
    deeporigin data new folder --name <name>  \n
     
    To create a folder within another folder, specify the parent:
     
    deeporigin data new folder \\\n    --name <name> \\ \n    --parent <parent-id>\n
     
    from deeporigin.data_hub import api\napi.create_workspace(name=\"test-folder\")\n
     
    To create a folder within another folder, specify the parent:
     
    api.create_workspace(\n    name=\"test-folder-2\",\n    parent_id=\"parent-id\",\n)\n
    "},{"location":"how-to/data-hub/create.html#databases","title":"Databases","text":"
    Databases can be created by specifying a name, and, optionally, a parent.
     CLIPython 
    If no parent is specified, the database will be created at the root level.
     
    deeporigin data new --name <name>  --database\n
     
    To create a folder within another folder, specify the parent:
     
    deeporigin data new database \\\n    --name <name> \\\n    --parent <parent-id>\n
     
    from deeporigin.data_hub import api\napi.create_database(name=\"test-database\")\n
     
    To create a folder within another folder, specify the parent:
     
    api.create_database(\n    name=\"test-database-2\",\n    parent_id=\"parent-id\",\n)\n
    "},{"location":"how-to/data-hub/create.html#database-columns","title":"Database columns","text":"
    Work in progress
     
    Currently, this package has limited support for creating database columns. We plan to expand the capabilities of this package.
     
    To create a new database column in an existing database, run:
     CLIPython 
    deeporigin data new column \\\n    --name <name> \\\n    --database <database-id> \\\n    --type <type>\n
     
    from deeporigin.data_hub import api\napi.add_database_column(\n    database_id=\"existing-database-id\",\n    type=\"integer\",\n    name=\"unique-name\",\n)\n
     
    This code creates a new column in the existing database. To configure the type of the column, use the type argument. The type must a member of DataType.
    "},{"location":"how-to/data-hub/delete.html","title":"Delete objects","text":"
    This document describes how to delete objects in the Deep Origin data hub:
     
       
    • Database rows
      •  
    • Database columns
      •  
    • Databases
      •  
    • Folders (workspaces)
      •  
     
    Exercise caution
     
       
    • Deleting a folder deletes all of the databases in the folder.
      •  
    • Deleting a column destroys all of the data in that column, including all of the files assigned to the cells in that column.
      •  
    • Deleting a database deletes all of the rows in the database.
      •  
     
    All resources will be deleted without asking for confirmation. 
    "},{"location":"how-to/data-hub/delete.html#delete-database-rows","title":"Delete database rows","text":"
    To delete a row in a database, run:
     CLIPython 
    deeporigin data delete \\\n    --row <row-id> \\\n    --database <database-id>\n
     
    from deeporigin.data_hub import api\napi.delete_rows(row_ids=[\"row-1\", \"row-2\"], database_id=\"database-id\")\n
     
    Deleting multiple rows
     
    Note that the python client allows you to delete multiple rows at once.
    "},{"location":"how-to/data-hub/delete.html#delete-databases","title":"Delete databases","text":"
    To delete an entire database, run:
     CLIPython 
    deeporigin data delete --database <db-id>\n
     
    Aliases
     
    The following alias also works: deeporigin data delete -d <db-id>.
     
    from deeporigin.data_hub import api\napi.delete_database(database_id=<db-id>)\n
    "},{"location":"how-to/data-hub/delete.html#delete-folders-workspaces","title":"Delete folders (workspaces)","text":"
    To delete an entire folder, including all contained databases, run:
     CLIPython 
    deeporigin data delete --folder <id>\n
     
    Aliases
     
    The following aliases also work --workspace, -w, --ws, -f instead of --folder.
     
    from deeporigin.data_hub import api\napi.delete_workspace(workspace_id=<folder-id>)\n
    "},{"location":"how-to/data-hub/delete.html#delete-database-column","title":"Delete database column","text":"
    To delete a column in a databas, run the following command, specifying the ID of the column to delete and its parent database:
     CLIPython 
    deeporigin data delete \\\n    --column <ids> \\\n    --database <database-id> \\\n
     
    from deeporigin.data_hub import api\napi.delete_database_column(\n    column_id=\"col-id\",\n    database_id=\"database-id\",\n)\n
    "},{"location":"how-to/data-hub/download-files.html","title":"Download files","text":"
    This page describes how to download files from Deep Origin to your local computer. 
    "},{"location":"how-to/data-hub/download-files.html#download-one-or-many-files-from-the-data-hub","title":"Download one or many files from the Data hub","text":"
    To download file(s) to the Deep Origin data hub, run the following commands:
     CLIPython 
    deeporigin data download-files\n
     
    This will download all files on Deep Origin to the current folder. 
     
    To download files that have been assigned to a particular row, use:
     
    deeporigin data download-files --assigned-row-ids <row-id-1>  <row-id-2> ...\n
     
    To download specific files, pass the file IDs using:
     
    deeporigin data download-files --file-ids <file-1> <file-1> ...\n
     
    from deeporigin.data_hub import api\napi.download_files(files)\n
     
    files is a list of files to download, and is a list of ListFilesResponse objects. To obtain this list, use api.list_files(), the output of which can be used as an input to download_files. 
     
    Download all files
     
    To download all files, call api.list_files() and pass the output to download_files.
    "},{"location":"how-to/data-hub/list-data.html","title":"List data","text":"
    This page describes how to list resources on Deep Origin. Listing folders (workspaces), databases, rows and files can be used to discover the resources available on Deep Origin, and show their IDs for further queries.
    "},{"location":"how-to/data-hub/list-data.html#list-folders","title":"List folders","text":"
    To list all of your Deep Origin folders, run:
     CLIPython 
    deeporigin data list --folders\n
     
    This will display a screen similar to below:
     
    \u256d\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u252c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u252c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u256e\n\u2502 Name            \u2502 Type       \u2502 ID            \u2502\n\u251c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u253c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u253c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2524\n\u2502 Secret Project  \u2502 workspace  \u2502 secret        \u2502\n\u2502 QC Efforts      \u2502 workspace  \u2502 qc-efforts    \u2502\n\u2502 Covid Target    \u2502 workspace  \u2502 corona        \u2502\n\u2570\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2534\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2534\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u256f\n
     JSON output with --json 
    JSON output can be requested by adding --json, and allows you to pipe out to a JSON processor like jq:
     
    deeporigin data list --folders --json | jq\n
     
    [\n  {\n    \"id\": \"_workspace:ncZhbnYXXfg0zWNcGKTnz\",\n    \"parentId\": null,\n    \"hid\": \"secret\",\n    \"type\": \"workspace\",\n    \"name\": \"Secret Project\"\n  },\n  {\n    \"id\": \"_workspace:sDTZKGZXOkhGw6XSg2Jla\",\n    \"parentId\": null,\n    \"hid\": \"qc-efforts\",\n    \"type\": \"workspace\",\n    \"name\": \"QC Efforts\"\n  },\n  {\n    \"id\": \"_workspace:UWhlb4Wyzh2R7bySapY2m\",\n    \"parentId\": null,\n    \"hid\": \"corona\",\n    \"type\": \"workspace\",\n    \"name\": \"Covid Target\"\n  }\n]\n
     Combining outputs 
    You can combine multiple output types. For example, to list all folders and databases:
     
    deeporigin data list --folders --databases\n
     
    from deeporigin.data_hub import api\napi.list_rows(row_type=\"workspace\")\n
    "},{"location":"how-to/data-hub/list-data.html#list-databases","title":"List databases","text":"
    To list all of your databases in Deep Origin, run:
     CLIPython 
    deeporigin data list --databases\n
     
    This will display a screen similar to below:
     
    \u256d\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u252c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u252c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u256e\n\u2502 Name           \u2502 Type      \u2502 ID             \u2502\n\u251c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u253c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u253c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2524\n\u2502 First Database \u2502 database  \u2502 first          \u2502\n\u2502 QC Efforts     \u2502 database  \u2502 qc-efforts     \u2502\n\u2502 Covid Target   \u2502 database  \u2502 corona         \u2502\n\u2570\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2534\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2534\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u256f\n
     JSON output with --json 
    JSON output can be requested by adding --json, and allows you to pipe out to a JSON processor like jq:
     
    deeporigin data list --databases --json | jq\n
     
    [\n  {\n    \"id\": \"_database:ncZhbnYXXfg0zWNcGKTnz\",\n    \"parentId\": \"_workspace:ncZhbnYXXfg0zWNcGKTnz\",\n    \"hid\": \"db-first\",\n    \"type\": \"database\",\n    \"name\": \"First Database\"\n  },\n  {\n    \"id\": \"_database:sDTZKGZXOkhGw6XSg2Jla\",\n    \"parentId\": \"_workspace:sDTZKGZXOkhGw6XSg2Jla\",\n    \"hid\": \"db-qc\",\n    \"type\": \"database\",\n    \"name\": \"QC Efforts\"\n  },\n  {\n    \"id\": \"_database:UWhlb4Wyzh2R7bySapY2m\",\n    \"parentId\": \"_workspace:UWhlb4Wyzh2R7bySapY2m\",\n    \"hid\": \"db-covid\",\n    \"type\": \"database\",\n    \"name\": \"Covid Target\"\n  }\n]\n
     Combining outputs 
    You can combine multiple output types. For example, to list all folders and databases:
     
    deeporigin data list --folders --databases\n
     
    from deeporigin.data_hub import api\napi.list_rows(row_type=\"database\")\n
    "},{"location":"how-to/data-hub/list-data.html#list-rows","title":"List rows","text":"
    To list all of your database rows in Deep Origin:
     CLIPython 
    deeporigin data list --rows\n
     
    This will display a screen similar to below:
     
    \u256d\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u252c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u252c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u256e\n\u2502 Name   \u2502 Type   \u2502 ID     \u2502\n\u251c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u253c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u253c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2524\n\u2502        \u2502 row    \u2502 data-1 \u2502\n\u2502        \u2502 row    \u2502 data-2 \u2502\n\u2502        \u2502 row    \u2502 data-3 \u2502\n\u2502        \u2502 row    \u2502 data-4 \u2502\n\u2502        \u2502 row    \u2502 data-5 \u2502\n\u2570\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2534\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2534\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u256f\n
     
    from deeporigin.data_hub import api\napi.list_rows(row_type=\"row\")\n
    "},{"location":"how-to/data-hub/list-data.html#list-files","title":"List files","text":"
    To list all of your files in Deep Origin, run:
     CLIPython 
    deeporigin data list --files\n
     
    This will display a screen similar to below:
     
    \u256d\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u252c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u252c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u256e\n\u2502 Name       \u2502 Status   \u2502 ID                          \u2502\n\u251c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u253c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u253c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2524\n\u2502 db-dna.csv \u2502 ready    \u2502 _file:gBAK9tzFC5Cegx4NmSETc \u2502\n\u2502 seqs.gz    \u2502 ready    \u2502 _file:FgVjcv8zzyPho6FME8QFp \u2502\n\u2502 db-rna.csv \u2502 ready    \u2502 _file:hnU7F62xeW8j0l1kR7YP1 \u2502\n\u2570\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2534\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2534\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u256f\n
     JSON output with --json 
    JSON output can be requested by adding --json, and allows you to pipe out to a JSON processor like jq:
     
    deeporigin data list --databases --json | jq\n
     
    [\n  {\n    \"file\": {\n      \"id\": \"_file:gBAK9tzFC5Cegx4NmSETc\",\n      \"uri\": \"s3://_file:gBAK9tzFC5Cegx4NmSETc\",\n      \"name\": \"db-dna.csv\",\n      \"status\": \"ready\",\n      \"contentLength\": 234,\n      \"contentType\": \"text/csv\",\n      \"dateCreated\": \"2024-05-08 01:01:48.925\",\n      \"dateUpdated\": \"2024-05-08 01:01:48.925\",\n      \"createdByUserDrn\": \"scientist@deeporigin.com\"\n    }\n  },\n  {\n    \"file\": {\n      \"id\": \"_file:FgVjcv8zzyPho6FME8QFp\",\n      \"uri\": \"s3://_file:FgVjcv8zzyPho6FME8QFp\",\n      \"name\": \"seqs.gz\",\n      \"status\": \"ready\",\n      \"contentLength\": 554588,\n      \"contentType\": \"zip/gz\",\n      \"dateCreated\": \"2024-05-08 18:08:09.149\",\n      \"dateUpdated\": \"2024-05-08 18:08:09.149\",\n      \"createdByUserDrn\": \"scientist@deeporigin.com\"\n    },\n    \"assignments\": [\n      {\n        \"rowId\": \"_row:WORR9xeGvG6mSg0yyDRlk\"\n      }\n    ]\n  },\n  {\n    \"file\": {\n      \"id\": \"_file:hnU7F62xeW8j0l1kR7YP1\",\n      \"uri\": \"s3://_file:hnU7F62xeW8j0l1kR7YP1\",\n      \"name\": \"db-rna.csv\",\n      \"status\": \"ready\",\n      \"contentLength\": 234,\n      \"contentType\": \"text/csv\",\n      \"dateCreated\": \"2024-05-08 18:07:57.655\",\n      \"dateUpdated\": \"2024-05-08 18:07:57.655\",\n      \"createdByUserDrn\": \"scientist@deeporigin.com\"\n    },\n    \"assignments\": [\n      {\n        \"rowId\": \"_row:mlNnmNkfktz7GT5qpjyrF\"\n      }\n    ]\n  }\n]\n
     
    Listing files cannot list other objects
     
    If you pass --files to the list command, all other  arguments are ignored. As a result, 
     
    deeporigin data list --files --databases\n
     will only list files.
     
    First, we start off by importing the necessary modules:
     
    We can list all files on Deep Origin using:
     
    from deeporigin.data_hub import api\napi.list_files()\n
     
    To find only unassigned files, we can use:
     
    api.list_files(is_unassigned=True)\n
     
    To find files that are assigned to a specific row:
     
    api.list_files(assigned_row_ids=[\"row-1\"])\n
    "},{"location":"how-to/data-hub/upload-files.html","title":"Upload files","text":"
    This page describes how to upload files to the Deep Origin data hub, and assign them to individual cells.
    "},{"location":"how-to/data-hub/upload-files.html#upload-a-file-to-the-data-hub","title":"Upload a file to the data hub","text":"
    To upload a file to the Deep Origin data hub, run the following commands:
     CLIPython 
    deeporigin data upload /path/to/test.fasta\n
     
    This will upload the file to your data hub, but the file will not yet be assigned to any database or cell. An example response is shown below:
     
    \u256d\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u252c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u256e\n\u2502 Property         \u2502 Value                        \u2502\n\u251c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u253c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2524\n\u2502 name             \u2502 test.fasta                   \u2502\n\u2502 contentType      \u2502 data/fasta                   \u2502\n\u2502 contentLength    \u2502 554588                       \u2502\n\u2502 id               \u2502 _file:36ufKT2Sej22coSEOizpK  \u2502\n\u2502 status           \u2502 ready                        \u2502\n\u2502 uri              \u2502 s3://foo                     \u2502\n\u2502 dateCreated      \u2502 2024-06-18T14:48:33.501Z     \u2502\n\u2502 dateUpdated      \u2502 2024-06-18T14:48:33.501Z     \u2502\n\u2502 createdByUserDrn \u2502 levins@deeporigin.com        \u2502\n\u2570\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2534\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u256f\n
     JSON output with --json 
    JSON output can be requested by adding --json, and allows you to pipe out to a JSON processor like jq:
     
    deeporigin upload /path/to/test.fasta | jq\n
     
    {\n  \"name\": \"test.fasta\",\n  \"contentType\": \"data/fasta\",\n  \"contentLength\": 554588,\n  \"id\": \"_file:36ufKT2Sej22coSEOizpK\",\n  \"status\": \"ready\",\n  \"uri\": \"s3://foo\",\n  \"dateCreated\": \"2024-06-18T14:51:43.876Z\",\n  \"dateUpdated\": \"2024-06-18T14:51:43.876Z\",\n  \"createdByUserDrn\": \"levins@deeporigin.com\"\n}\n
     
    from deeporigin.data_hub import api\napi.upload_file(\"/path/to/file.fasta\")\n
     
    This will upload the file to your data hub. An example is shown below:
     
    {\n    \"name\": \"file.fasta\",\n    \"contentType\": \"data/foo\",\n    \"contentLength\": 55454688,\n    \"id\": \"_file:6Hdhyc3t8xZ6pmyCrQy1t\",\n    \"status\": \"ready\",\n    \"uri\": \"s3://data.<org-name>/_file:6Hdhyc3t8xZ6pmyCrQy1t\",\n    \"dateCreated\": \"2024-06-18T14:18:37.409Z\",\n    \"dateUpdated\": \"2024-06-18T14:18:37.409Z\",\n    \"createdByUserDrn\": \"haldane@deeporigin.com\",\n}\n
    "},{"location":"how-to/data-hub/upload-files.html#upload-a-file-to-an-existing-row","title":"Upload a file to an existing row","text":"
    To upload a file and assign it to a cell in an existing row, run the following commands:
     CLIPython 
    deeporigin data upload /path/to/test.fasta \\\n    --column <column_id> \\\n    --database <database_id> \\\n    --row <row_id>\n
     
    from deeporigin.data_hub import api\napi.upload_file(\"/path/to/file.fasta\")\n
     
    To assign an uploaded file to a cell in an existing row, run the assign_files_to_cell function:
     
        api.assign_files_to_cell(\n    file_ids=[\"_file:6Hdhyc3t8xZ6pmyCrQy1t\"],\n    database_id=\"db-dna\",\n    column_id=\"base_sequence_file\",\n    row_id=\"row-id\",\n)\n
    "},{"location":"how-to/data-hub/upload-files.html#upload-a-file-to-a-new-row-of-a-database","title":"Upload a file to a new row of a database","text":"
    To upload a file and assign it to a column in a new row, run the following commands:
     CLIPython 
    deeporigin data upload /path/to/test.fasta \\\n    --column <column_id> \\\n    --database <database_id> \n
     
    This omits the --row parameter, which would create a new row in the database.
     
    First, upload a file to your data hub by running:
     
    from deeporigin.data_hub import api\napi.upload_file(\"/path/to/file.fasta\")\n
     
    Second, assign the file to a new row by running:
     
    api.assign_files_to_cell(\n    file_ids=[\"_file:6Hdhyc3t8xZ6pmyCrQy1t\"],\n    database_id=\"db-dna\",\n    column_id=\"base_sequence_file\",\n)\n
    "},{"location":"how-to/data-hub/view-data.html","title":"View data","text":"
    This page describes how to describe and show the details of data objects in Deep Origin. To simply list objects, see List data.
    "},{"location":"how-to/data-hub/view-data.html#describe-data","title":"Describe data","text":""},{"location":"how-to/data-hub/view-data.html#describe-rows","title":"Describe rows","text":"
    Describing rows provides metadata about the row, such as its ID, parent, and status.
     
    Describe vs. Show
     
    This does not show you information in that row. To see data contained in that row, use the show command.
     
    To describe a row in a database in Deep Origin, run:
     CLIPython 
    deeporigin data describe <row-id>\n
     
    This will display a table similar to:
     
    \u256d\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u252c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u256e\n\u2502 Column           \u2502 Value                              \u2502\n\u251c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u253c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2524\n\u2502 id               \u2502 _row:WORR9xeGvG6mSg0yyDRlk         \u2502\n\u2502 parentId         \u2502 _database:kyEws11L4KagGAaqRwONv    \u2502\n\u2502 type             \u2502 row                                \u2502\n\u2502 dateCreated      \u2502 2024-05-08 17:59:32.512306         \u2502\n\u2502 dateUpdated      \u2502 2024-05-08 18:08:13.103            \u2502\n\u2502 createdByUserDrn \u2502 scientist@deeporigin.com           \u2502\n\u2502 editedByUserDrn  \u2502 scientist@deeporigin.com           \u2502\n\u2502 hid              \u2502 data-2                             \u2502\n\u2502 validationStatus \u2502 valid                              \u2502\n\u2570\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2534\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u256f\n
     JSON output with --json 
    JSON output can be requested by adding --json, and allows you to pipe out to a JSON processor like jq:
     
    deeporigin data describe <row-id> --json | jq\n
     
    {\n  \"id\": \"_row:WORR9xeGvG6mSg0yyDRlk\",\n  \"parentId\": \"_database:kyEws11L4KagGAaqRwONv\",\n  \"type\": \"row\",\n  \"dateCreated\": \"2024-05-08 17:59:32.512306\",\n  \"dateUpdated\": \"2024-05-08 18:08:13.103\",\n  \"createdByUserDrn\": \"scientist@deeporigin.com\",\n  \"editedByUserDrn\": \"scientist@deeporigin.com\",\n  \"hid\": \"data-2\",\n  \"validationStatus\": \"valid\"\n}\n
     
    from deeporigin.data_hub import api\napi.describe_row(\"_row:WORR9xeGvG6mSg0yyDRlk\")\n
    "},{"location":"how-to/data-hub/view-data.html#describe-files","title":"Describe files","text":"
    To describe a file in a database in Deep Origin, run:
     CLIPython 
    deeporigin data describe <file-id>\n
     
    This will display a table similar to:
     
    \u256d\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u252c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u256e\n\u2502 Property         \u2502 Value                             \u2502\n\u251c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u253c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2524\n\u2502 id               \u2502 _file:gBAK9tzFC5Cegx4NmSETc       \u2502\n\u2502 uri              \u2502 s3://_file:gBAK9tzFC5Cegx4NmSETc  \u2502\n\u2502 name             \u2502 db-dna.csv                        \u2502\n\u2502 status           \u2502 ready                             \u2502\n\u2502 contentLength    \u2502 234                               \u2502\n\u2502 contentType      \u2502 text/csv                          \u2502\n\u2502 dateCreated      \u2502 2024-05-08 01:01:48.925           \u2502\n\u2502 dateUpdated      \u2502 2024-05-08 01:01:48.925           \u2502\n\u2502 createdByUserDrn \u2502 scientist@deeporigin.com          \u2502\n\u2570\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2534\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u256f\n
     JSON output with --json 
    JSON output can be requested by adding --json, and allows you to pipe out to a JSON processor like jq:
     
    deeporigin data describe <file-id> --json | jq\n
     
    {\n  \"id\": \"_file:gBAK9tzFC5Cegx4NmSETc\",\n  \"uri\": \"s3://_file:gBAK9tzFC5Cegx4NmSETc\",\n  \"name\": \"db-dna.csv\",\n  \"status\": \"ready\",\n  \"contentLength\": 234,\n  \"contentType\": \"text/csv\",\n  \"dateCreated\": \"2024-05-08 01:01:48.925\",\n  \"dateUpdated\": \"2024-05-08 01:01:48.925\",\n  \"createdByUserDrn\": \"scientist@deeporigin.com\"\n}\n
     
    from deeporigin.data_hub import api\napi.describe_file(\"file-id\")\n
    "},{"location":"how-to/data-hub/view-data.html#show-data","title":"Show data","text":""},{"location":"how-to/data-hub/view-data.html#show-rows","title":"Show rows","text":"
    To show the data in a row in a database in Deep Origin, run:
     CLIPython 
    deeporigin data show <row-id>\n
     
    This will display a table similar to:
     
    \u256d\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u252c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u256e\n\u2502 Column    \u2502 Value                       \u2502\n\u251c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u253c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2524\n\u2502 File      \u2502 _file:hnU7F62xeW8j0l1kR7YP1 \u2502\n\u2502 Float Num \u2502 112                         \u2502\n\u2502 selctcol  \u2502 sdsd                        \u2502\n\u2570\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2534\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u256f\n
     JSON output with --json 
    JSON output can be requested by adding --json, and allows you to pipe out to a JSON processor like jq:
     
    deeporigin data describe <file-id> --json | jq\n
     
    {\n  \"File\": \"_file:hnU7F62xeW8j0l1kR7YP1\",\n  \"Float Num\": 112,\n  \"selctcol\": \"sdsd\"\n}\n
     
    from deeporigin.data_hub import  api\napi.get_row_data(\"row-id\")\n
     
    The data will be returned as a dictionary, where the keys are the column names and the values are values of the cells.
    "},{"location":"how-to/data-hub/view-data.html#show-databases","title":"Show databases","text":"CLIPython 
    deeporigin data show <database-id>\n
     
    This will display a table similar to:
     
    \u256d\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u252c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u252c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u252c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u252c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u256e\n\u2502  Status   \u2502 stag-id   \u2502 Customer Name    \u2502 Status     \u2502  Output Files     \u2502\n\u251c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u253c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u253c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u253c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u253c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2524\n\u2502 valid     \u2502 stag-1    \u2502 Blue Sun Corp    \u2502 Processing \u2502                   \u2502\n\u2502 valid     \u2502 stag-2    \u2502 Veridian Dynamics\u2502 Complete   \u2502   report.tar.gz   \u2502\n\u2570\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2534\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2534\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2534\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2534\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u256f\n
     JSON output with --json 
    JSON output can be requested by adding --json, and allows you to pipe out to a JSON processor like jq:
     
    deeporigin data describe <database-id> --json | jq\n
     
    {\n  \"Status\": [\n    \"valid\",\n    \"valid\"\n  ],\n  \"stag-id\": [\n    \"stag-1\",\n    \"stag-2\"\n  ],\n  \"Customer Name\": [\n    \"Blue Sun Corp \",\n    \"Veridian Dynamics\"\n  ],\n  \"Status\": [\n    \"Processing\",\n    \"Complete\"\n  ],\n  \"Output Files\": [\n    null,\n    \"report.tar.gz\"\n  ]\n}\n
     
    from deeporigin.data_hub import api\napi.get_dataframe(\"database-id\")\n
     
    The data will be returned as a Pandas DataFrame.
    "},{"location":"how-to/data-hub/write-data.html","title":"Write data","text":"
    This page describes how to write data to the Deep Origin data hub.
    "},{"location":"how-to/data-hub/write-data.html#write-data-to-a-cell-in-a-database","title":"Write data to a cell in a database","text":""},{"location":"how-to/data-hub/write-data.html#write-text-data","title":"Write text data","text":"
    Run the following to write a text value to a cell in a database:
     CLIPython 
    deeporigin data write \"some-string\" \\\n    --database $database_id \\\n    --column $column_id \\\n    --row $row_id\n
     
    from deeporigin.data_hub import api\napi.set_cell_data(\n    \"some string\",\n    database_id=\"database ID or name\",\n    column_id=\"column ID or programmatic key\",\n    row_id=\"row ID\",\n)\n
    "},{"location":"how-to/data-hub/write-data.html#write-numeric-data","title":"Write numeric data","text":"
    Run the following to write a numeric value to a cell in a database:
     CLIPython 
    deeporigin data write 123 \\\n    --database $database_id \\\n    --column $column_id \\\n    --row $row_id\n
     
    from deeporigin.data_hub import api\napi.set_cell_data(\n    1,\n    database_id=\"database ID or name\",\n    column_id=\"column ID or programmatic key\",\n    row_id=\"row ID\",\n)\n
     
    Numeric data will be coerced to the data type of the underlying cell.
    "},{"location":"how-to/data-hub/write-data.html#write-select-data","title":"Write select data","text":"
    This section describes how to write data to a cell in a database that is of type select. This includes cells where a single option can be selected from a list, and cells where more than one value can be selected from a list of options.
     CLIPython 
    deeporigin data write \"option A\" \\\n    --database $database_id \\\n    --column $column_id \\\n    --row $row_id\n
     
    from deeporigin.data_hub import api\napi.set_cell_data(\n    \"option A\",\n    database_id=\"database ID or name\",\n    column_id=\"column ID or programmatic key\",\n    row_id=\"row ID\",\n)\n
     
    The value must be one of the options in the list. If it is not, an error will be raised showing the list of legal options.
    "},{"location":"how-to/data-hub/write-data.html#write-boolean-data","title":"Write Boolean data","text":"
    Run the following to write a Boolean value to a cell in a database:
     CLIPython 
    deeporigin data write \"True\" \\\n    --database $database_id \\\n    --column $column_id \\\n    --row $row_id\n
     
    from deeporigin.data_hub import api\napi.set_cell_data(\n    True,\n    database_id=\"database ID or name\",\n    column_id=\"column ID or programmatic key\",\n    row_id=\"row ID\",\n)\n
     Unsetting Boolean data 
    To unset a cell, so that it contains no data, write None to the cell as follows: 
     
    from deeporigin.data_hub import api\napi.set_cell_data(\n    None,\n    database_id=\"database ID or name\",\n    column_id=\"column ID or programmatic key\",\n    row_id=\"row ID\",\n)\n
    "},{"location":"how-to/platform/user-info.html","title":"Get user information","text":""},{"location":"how-to/platform/user-info.html#get-info-about-current-user","title":"Get info about current user","text":"
    To get information about the currently logged in user, including the user ID, use:
     
    from deeporigin.platform import api\napi.whoami()\n
     
    returns information about the current user. A typical response is:
     
    {\n    \"data\": {\n        \"attributes\": {\n            \"company\": null,\n            \"expertise\": null,\n            \"industries\": null,\n            \"pendingInvites\": [],\n            \"platform\": \"OS\",\n            \"title\": null\n        },\n        \"id\": \"google-apps|user@deeporigin.com\",\n        \"type\": \"User\"\n    },\n    \"links\": {\n        \"self\": \"https://os.deeporigin.io/users/me\"\n    }\n}\n
    "},{"location":"how-to/platform/user-info.html#get-information-about-a-user","title":"Get information about a user","text":"
    To get information about a user, use:
     
    from deeporigin.platform import api\napi.resolve_user(\"user-id\")\n
     
    where user-id is the ID of the user, in the format returned by api.whoami(). A typical response looks like:
     
    {\n    \"data\": {\n        \"attributes\": {\n            \"avatar\": \"https://...\",\n            \"email\": \"user@deeporigin.com\",\n            \"name\": \"User Name\"\n        },\n        \"id\": \"918ddd25-ab97-4400-9a14-7a8be1216754\",\n        \"type\": \"User\"\n    },\n    \"links\": {\n        \"self\": \"https://...\"\n    }\n}\n
    "},{"location":"how-to/platform/workstation-info.html","title":"Get information about workstations","text":"
    To list all workstations on Deep Origin, use:
     
    from deeporigin.platform import api\napi.get_workstations()\n
     
    This returns a list of objects, where each object correspond to a workstation. A typical entry looks like:
     
    {\n    \"attributes\": {\n        \"accessMethods\": [\n            {\n                \"icon\": \"/assets/icons/catalog-items/jupyterlab.svg\",\n                \"id\": \"jupyterlab\",\n                \"name\": \"JupyterLab\"\n            },\n            {\n                \"icon\": \"/assets/icons/catalog-items/code-server.svg\",\n                \"id\": \"code-server\",\n                \"name\": \"VS Code (web)\"\n            }\n        ],\n        \"accessSettings\": {\n            \"publicKey\": \"ssh-ed25519 ... \",\n            \"ssh\": true\n        },\n        \"autoStopIdleCPUThreshold\": 0,\n        \"autoStopIdleDuration\": 30,\n        \"blueprint\": \"deeporigin/deeporigin-python:staging\",\n        \"cloudProvider\": {\n            \"region\": \"us-west-2\",\n            \"vendor\": \"aws\"\n        },\n        \"clusterId\": \"3bb775e4-8be6-4936-a6b9\",\n        \"created\": \"2024-10-05T17:01:06.840Z\",\n        \"description\": \"dfd\",\n        \"drn\": \"drn:...\",\n        \"enableAutoStop\": true,\n        \"name\": \"forthcoming-tyrannosaurus-8fd\",\n        \"nextUserActions\": [\n            \"DELETE\"\n        ],\n        \"orgHandle\": \"deeporigin-com\",\n        \"requestedResources\": {\n            \"cpu\": 8,\n            \"gpu\": 0,\n            \"gpuSize\": \"NONE\",\n            \"memory\": 32,\n            \"storage\": 250\n        },\n        \"state\": {\n            \"error\": \"\",\n            \"isError\": false,\n            \"stage\": \"READY\",\n            \"status\": \"TERMINATED\"\n        },\n        \"status\": \"TERMINATED\",\n        \"summary\": \"\",\n        \"templateVersion\": \"v0.1.0\",\n        \"updated\": \"2024-10-07T12:46:46.511Z\",\n        \"userHandle\": \"google-apps|srinivas@deeporigin.com\",\n        \"volumeDrns\": [\n            \"...\"\n        ],\n        \"wasAutoStopped\": false\n    },\n    \"id\": \"...\",\n    \"type\": \"ComputeBench\"\n}\n
    "},{"location":"how-to/tools/list-tools.html","title":"List tools","text":"
    This document describes how to discover and list tools on the Deep Origin platform. 
     
    First, available tools are listed on the panel on left, with documentation on each tool and how to run them. 
     
    Coming soon
     
    More tools will be added soon. The ability to list tools from the API is coming soon.
    "},{"location":"how-to/tools/run-tools.html","title":"Run tools","text":"
    This document describes how to run tools on the Deep Origin platform. 
    "},{"location":"platform/index.html","title":"Platform API","text":"
    The Deep Origin CLI and python client allows you to control and interact with the Deep Origin platform. 
    "},{"location":"ref/data-hub/high-level-api.html","title":"API reference: High-level API","text":"
    How to use this reference
     
    This page contains information about each class and function in this module. This is meant as a detailed reference for this module. If you're looking an introduction, we recommend reviewing the How to section.
     
    The deeporigin.data_hub.api module contains high-level functions for interacting with your Deep Origin data hub.
    "},{"location":"ref/data-hub/high-level-api.html#src.data_hub.api.add_database_column","title":"add_database_column","text":"
    add_database_column(\n    *,\n    database_id: str,\n    type: DataType,\n    name: str,\n    cardinality: Cardinality = \"one\",\n    required: bool = False,\n    client=None,\n    _stash: bool = False\n)\n
     
    Add a column to a database.
     
    Parameters:
     Name Type Description Default database_id str 
    ID (or human ID) of a database on Deep Origin.
     required type DataType 
    type of the column. Should be one of DataType
     required name str 
    name of the column
     required cardinality Cardinality 
    cardinality of the column. Specifies whether cells in this column can contain or many items. Should be one of \"one\" or \"many\"
     'one' required bool 
    whether the column is required. If True, cells in this column cannot be empty
     False"},{"location":"ref/data-hub/high-level-api.html#src.data_hub.api.add_database_rows","title":"add_database_rows","text":"
    add_database_rows(\n    *,\n    database_id: str,\n    data: dict,\n    client=None,\n    _stash: bool = False\n) -> list[str]\n
     
    Add new data to a database.
     
    Use this function to add new rows, or fragments of rows, to a Deep Origin database.
     
    Parameters:
     Name Type Description Default database_id str 
    Human ID or System ID of the database
     required data dict 
    A dictionary where each key is a column name and each value is a list of values. All values should have the same length. Key names should match column names in the database.
     required 
    Returns:
     Type Description list[str] 
    A list of row IDs
    "},{"location":"ref/data-hub/high-level-api.html#src.data_hub.api.assign_files_to_cell","title":"assign_files_to_cell","text":"
    assign_files_to_cell(\n    *,\n    file_ids: list[str],\n    database_id: str,\n    column_id: str,\n    row_id: Optional[str] = None,\n    client=None,\n    _stash: bool = False\n)\n
     
    Assign existing file(s) to a cell
     
    Assign files to a cell in a database table, where the cell is identified by the database ID, row ID, and column ID.
     
    If row_id is None, a new row will be created.
     
    Parameters:
     Name Type Description Default file_ids list[str] 
    ID of the file
     required database_id str 
    ID of database to assign to
     required column_id str 
    ID of the column
     required row_id Optional[str] 
    ID of the row
     None"},{"location":"ref/data-hub/high-level-api.html#src.data_hub.api.convert_id_format","title":"convert_id_format","text":"
    convert_id_format(\n    *,\n    hids: Optional[Union[list[str], set[str]]] = None,\n    ids: Optional[Union[list[str], set[str]]] = None,\n    client=None,\n    _stash: bool = False\n) -> list[dict]\n
     
    Convert a list of human IDs to IDs or vice versa.
     
    Parameters:
     Name Type Description Default hids Optional[Union[list[str], set[str]]] 
    List of human IDs
     None ids Optional[Union[list[str], set[str]]] 
    List of IDs (system IDs)
     None"},{"location":"ref/data-hub/high-level-api.html#src.data_hub.api.create_database","title":"create_database","text":"
    create_database(\n    *,\n    name: str,\n    client=None,\n    _stash: bool = False,\n    parent_id: Optional[str] = None,\n    hid: Optional[str] = None,\n    hid_prefix: Optional[str] = None\n)\n
     
    Create a new database in the data hub
     
    A database contains rows of data.
     
    Parameters:
     Name Type Description Default name str 
    Name of the database to create
     required hid Optional[str] 
    Human ID. If not specified, the name will be used
     None parent_id Optional[str] 
    ID of the parent. If None, the folder is created at the root level
     None hid_prefix Optional[str] 
    Human ID prefix to be used for each row. If not specified, the name will be used
     None"},{"location":"ref/data-hub/high-level-api.html#src.data_hub.api.create_workspace","title":"create_workspace","text":"
    create_workspace(\n    *,\n    name: str,\n    hid: Optional[str] = None,\n    parent_id: Optional[str] = None,\n    client=None,\n    _stash: bool = False\n)\n
     
    Create a new folder (workspace) in the data hub
     
    A folder contains can contain other rows and databases.
     
    Parameters:
     Name Type Description Default name str 
    Name of the folder to create
     required hid Optional[str] 
    Human ID. If not specified, the name will be used
     None parent_id Optional[str] 
    ID of the parent. If None, the folder is created at the root level
     None"},{"location":"ref/data-hub/high-level-api.html#src.data_hub.api.download","title":"download","text":"
    download(\n    source: str,\n    destination: str,\n    *,\n    include_files: bool = False,\n    client=None,\n    _stash: bool = False\n) -> None\n
     
    Download resources from Deep Origin and save them to a local destination.
     
    Download databases, objects and other entities from your Deep Origin data hub and save them to local disk.
     Work in progress 
    All features in this function have not been implemented yet.
     
    Parameters:
     Name Type Description Default source str 
    ID (or human ID) of a resource on Deep Origin.
     required destination str 
    Path to local directory to save resources.
     required include_files bool 
    if True, download files in database.
     False"},{"location":"ref/data-hub/high-level-api.html#src.data_hub.api.download_database","title":"download_database","text":"
    download_database(\n    source: Any,\n    destination: str = getcwd(),\n    *,\n    include_files: bool = False,\n    client=None,\n    _stash: bool = False\n) -> None\n
     
    Download a database and save it to a CSV file on the local disk.
     
    Download a database from your Deep Origin data hub and save to local disk as a CSV file.
     
    Parameters:
     Name Type Description Default source Any 
    ID (or human ID) of a resource on Deep Origin.
     required destination str 
    Path to local directory to save resources.
     getcwd() include_files bool 
    if True, download files in database.
     False"},{"location":"ref/data-hub/high-level-api.html#src.data_hub.api.download_files","title":"download_files","text":"
    download_files(\n    *,\n    files: Optional[list[dict]] = None,\n    file_ids: Optional[list[str]] = None,\n    save_to_dir: Path | str = Path(\".\"),\n    use_file_names: bool = True,\n    client=None,\n    _stash: bool = False\n) -> None\n
     
    download multiple files in parallel to local disk
     
    Parameters:
     Name Type Description Default files Optional[list[dict]] 
    list of files to download. These can be a list of file_ids or a list of files as returned by api.list_files
     None save_to_dir Path | str 
    directory to save files to on local computer
     Path('.') use_file_names bool 
    If True, refer to files by name rather than ID.
     True"},{"location":"ref/data-hub/high-level-api.html#src.data_hub.api.get_cell_data","title":"get_cell_data","text":"
    get_cell_data(\n    *,\n    row_id: str,\n    column_name: str,\n    client=None,\n    _stash: bool = False\n) -> Any\n
     
    Extract data from a cell in a database, referenced by row_id and column_name.
     
    Returns the value in a single cell in a database.
     Caution 
    This function internally calls get_row_data, so it is not efficient to write a loop to get all values of cells from a row. It will be faster to call get_row_data directly.
     
    Parameters:
     Name Type Description Default row_id str 
    ID (or human ID) of a row.
     required column_name str 
    Name of column.
     required 
    Returns:
     Type Description Any 
    Value of that cell.
    "},{"location":"ref/data-hub/high-level-api.html#src.data_hub.api.get_columns","title":"get_columns","text":"
    get_columns(\n    row_id: str, *, client=None, _stash: bool = False\n) -> list[dict]\n
     
    Get information about the columns of a row or database.
     
    If row_id is a database, then column metadata and names are returned. If row_id is a row, then a dictionary of human IDs and values are returned.
     
    Parameters:
     Name Type Description Default row_id str 
    ID (or human ID) of a row or database on Deep Origin.
     required"},{"location":"ref/data-hub/high-level-api.html#src.data_hub.api.get_dataframe","title":"get_dataframe","text":"
    get_dataframe(\n    database_id: str,\n    *,\n    use_file_names: bool = True,\n    reference_format: IDFormat = \"human-id\",\n    return_type: DatabaseReturnType = \"dataframe\",\n    filter: Optional[dict] = None,\n    client=None,\n    _stash: bool = False\n)\n
     
    Generate a pandas.DataFrame or dictionary for a database.
     
    Download a database from your Deep Origin data hub and return it as a data frame or dictionary.
     
    Parameters:
     Name Type Description Default database_id str 
    ID (or human ID) of a database on Deep Origin.
     required use_file_names bool 
    If True, refer to files by name rather than ID.
     True reference_format IDFormat 
    Refer to rows on Deep Origin using human IDs or system IDs.
     'human-id' return_type DatabaseReturnType 
    Whether to return a pandas.Dataframe or a dictionary.
     'dataframe'"},{"location":"ref/data-hub/high-level-api.html#src.data_hub.api.get_notebook","title":"get_notebook","text":"
    get_notebook(\n    row_id: str, *, client=None, _stash: bool = False\n) -> list\n
     
    Get the notebook of a row, if it exists
     
    Parameters:
     Name Type Description Default row_id str 
    ID (or human ID) of a row on Deep Origin.
     required 
    Returns:
     Type Description list 
    The notebook of the row, returned as a list
     list 
    of blocks
    "},{"location":"ref/data-hub/high-level-api.html#src.data_hub.api.get_row_data","title":"get_row_data","text":"
    get_row_data(\n    row_id: str,\n    *,\n    use_column_keys: bool = False,\n    client=None,\n    _stash: bool = False\n) -> dict\n
     
    Get the data in a row.
     
    Read data from a row, and return it as a dictionary, where the keys are column names (or keys), and the values are the values of those cells.
     
    Parameters:
     Name Type Description Default row_id str 
    ID (or human ID) of a row or database on Deep Origin.
     required use_column_keys bool 
    if True, keys of dictionary are column keys.
     False 
    Raises:
     Type Description DeepOriginException 
    If row_id is not a row
    "},{"location":"ref/data-hub/high-level-api.html#src.data_hub.api.get_tree","title":"get_tree","text":"
    get_tree(\n    *,\n    include_rows: bool = True,\n    client=None,\n    _stash: bool = False\n) -> list\n
     
    Construct a tree of all folders (workspaces), databases and rows.
     
    Returns a tree that contains all folders, databases and (optionally) rows. The tree is returned as a dictionary, and children of each object are contained in a field called children.
     
    Parameters:
     Name Type Description Default include_rows bool 
    If True, rows are included in the tree.
     True 
    Returns:
     Type Description list 
    A dictionary describing the tree structure of all folders
     list 
    and databases.
    "},{"location":"ref/data-hub/high-level-api.html#src.data_hub.api.list_files","title":"list_files","text":"
    list_files(\n    *,\n    assigned_row_ids: Optional[list[str]] = None,\n    is_unassigned: Optional[bool] = None,\n    file_ids: Optional[list[str]] = None,\n    client=None,\n    _stash: bool = False\n) -> list\n
     
    List files, with option to filter by assigned rows, assigned status
     
    Returns a list of files.
     
    Parameters:
     Name Type Description Default assigned_row_ids Optional[list[str]] 
    List of IDs of rows that files are assigned to
     None is_unassigned Optional[bool] 
    If True only files that are unassigned will be returned
     None 
    Returns:
     Type Description list 
    A list of files, where each entry is an object that corresponds to a file on Deep Origin
    "},{"location":"ref/data-hub/high-level-api.html#src.data_hub.api.list_rows","title":"list_rows","text":"
    list_rows(\n    *,\n    parent_id: Optional[str] = None,\n    row_type: ObjectType = None,\n    parent_is_root: Optional[bool] = None,\n    client=None,\n    _stash: bool = False\n) -> list\n
     
    List rows in a database or folder (workspace).
     
    Returns a list of rows from folders and databases, based on the parent, row type, or whether the parent is the root.
     
    Parameters:
     Name Type Description Default parent_id Optional[str] 
    ID (or human ID) or the parent.
     None row_type ObjectType 
    One of row, folder, or database.
     None parent_is_root Optional[bool] 
    If True only rows that are children of the root will be returned.
     None 
    Returns:
     Type Description list 
    A list of objects, where each entry corresponds to a row.
    "},{"location":"ref/data-hub/high-level-api.html#src.data_hub.api.make_database_rows","title":"make_database_rows","text":"
    make_database_rows(\n    database_id: str,\n    n_rows: int = 1,\n    *,\n    client=None,\n    _stash: bool = False\n) -> dict\n
     
    Makes one or several new row(s) in a database table
     
    Parameters:
     Name Type Description Default database_id str 
    ID or Human ID of the database
     required n_rows int 
    Number of rows to create. Must be an integer greater than 0
     1 
    Returns:
     Type Description dict 
    A dictionary that conforms to a EnsureRowsResponse
    "},{"location":"ref/data-hub/high-level-api.html#src.data_hub.api.row_to_dict","title":"row_to_dict","text":"
    row_to_dict(\n    row: dict,\n    *,\n    file_ids: Optional[list] = None,\n    reference_ids: Optional[list] = None\n) -> dict\n
     
    convert a database row (as returned by api.list_database_rows) to a dictionary where keys are column IDs and values are the values in the row
     This function mutates inputs 
    This function mutates file_ids and reference_ids
     
    Parameters:
     Name Type Description Default row dict 
    database row (as returned by api.list_database_rows)
     required file_ids Optional[list] 
    list of file IDs, will be mutated in-place
     None reference_ids Optional[list] 
    list of reference IDs, will be mutated in-place
     None 
    Returns:
     Type Description dict 
    dict
    "},{"location":"ref/data-hub/high-level-api.html#src.data_hub.api.set_cell_data","title":"set_cell_data","text":"
    set_cell_data(\n    value: Any,\n    *,\n    database_id: str,\n    row_id: str,\n    column_id: str,\n    client=None,\n    _stash: bool = False\n) -> Any\n
     
    Set data in a cell to some value.
     
    Parameters:
     Name Type Description Default value Any 
    Value to set in the cell
     required database_id str 
    ID (or human ID) of a database
     required row_id str 
    ID (or human ID) of a row
     required column_id str 
    ID (or human ID) of a column
     required"},{"location":"ref/data-hub/high-level-api.html#src.data_hub.api.set_data_in_cells","title":"set_data_in_cells","text":"
    set_data_in_cells(\n    *,\n    values: list,\n    row_ids: list[str],\n    column_id: str,\n    database_id: str,\n    columns: Optional[list[dict]] = None,\n    client=None,\n    _stash: bool = False\n)\n
     
    Set data in multiple cells to some value.
    "},{"location":"ref/data-hub/high-level-api.html#src.data_hub.api.upload_file","title":"upload_file","text":"
    upload_file(\n    file_path: str,\n    *,\n    client=None,\n    _stash: bool = False,\n    compute_hash: bool = True\n)\n
     
    Upload a file to Deep Origin.
     
    This upload files to your Deep Origin data hub. To assign this file to a cell, next run assign_files_to_cell
     
    Parameters:
     Name Type Description Default file_path str 
    Path to the file to upload
     required"},{"location":"ref/data-hub/high-level-api.html#src.data_hub.api.upload_file_to_new_database_row","title":"upload_file_to_new_database_row","text":"
    upload_file_to_new_database_row(\n    *,\n    database_id: str,\n    file_path: str,\n    column_id: str,\n    client=None,\n    _stash: bool = False\n)\n
     
    Upload a file to a new row in a database.
     
    Upload a file to a new row in a database. This utility function wraps two other functions:
     
       
    • upload_file
      •  
    • assign_files_to_cell
      •  
     
    Parameters:
     Name Type Description Default database_id str 
    ID (or human ID) of a database.
     required file_path str 
    Path to the file to upload.
     required column_id str 
    ID (or human ID) of a column in the database.
     required"},{"location":"ref/data-hub/low-level-api.html","title":"API reference: Low-level API","text":""},{"location":"ref/data-hub/low-level-api.html#background","title":"Background","text":"
    We use automatically generated code to implement a low-level Python SDK that connects to the Deep Origin data hub API. This page describes that API. In most cases, you will not need to know how this works, nor will you need to use it.
     
    Using the methods in the DeeporiginData class
     
    The deeporigin.api module provides wrappers that allow you to use methods in the deeporigin_data.DeeporiginData class, without needing to instantiate an object and configure it. Each method of this class is exposed as a function with the same name. These functions enable you to easily use the methods of the deeporigin_data.DeeporiginData class.
     
    For example, to use the list_files method in the DeeporiginData class, run:
     
    from deeporigin.data_hub import api\napi.list_files()\n
     
    Your IDE should be able to provide information about the arguments and return types of these functions by typing api.list_files( and then pressing tab.    
    "},{"location":"ref/data-hub/low-level-api.html#deeporigin_data._client.AsyncDeeporiginData","title":"AsyncDeeporiginData","text":"
                   Bases: AsyncAPIClient
    "},{"location":"ref/data-hub/low-level-api.html#deeporigin_data._client.AsyncDeeporiginData.__init__","title":"__init__","text":"
    __init__(\n    *,\n    token: str | None = None,\n    org_id: str | None = None,\n    base_url: str | URL | None = None,\n    timeout: Union[\n        float, Timeout, None, NotGiven\n    ] = NOT_GIVEN,\n    max_retries: int = DEFAULT_MAX_RETRIES,\n    default_headers: Mapping[str, str] | None = None,\n    default_query: Mapping[str, object] | None = None,\n    http_client: AsyncClient | None = None,\n    _strict_response_validation: bool = False\n) -> None\n
     
    This automatically infers the following arguments from their corresponding environment variables if they are not provided: - token from ORG_BEARER_TOKEN - org_id from ORG_ID
    "},{"location":"ref/data-hub/low-level-api.html#deeporigin_data._client.AsyncDeeporiginData.add_database_column","title":"add_database_column  async","text":"
    add_database_column(\n    *,\n    column: Column,\n    database_id: str,\n    extra_headers: Headers | None = None,\n    extra_query: Query | None = None,\n    extra_body: Body | None = None,\n    timeout: float | Timeout | None | NotGiven = NOT_GIVEN\n) -> AddDatabaseColumnResponse\n
     
    Add a column to a database.
     
    Parameters:
     Name Type Description Default extra_headers Headers | None 
    Send extra headers
     None extra_query Query | None 
    Add additional query parameters to the request
     None extra_body Body | None 
    Add additional JSON properties to the request
     None timeout float | Timeout | None | NotGiven 
    Override the client-level default timeout for this request, in seconds
     NOT_GIVEN"},{"location":"ref/data-hub/low-level-api.html#deeporigin_data._client.AsyncDeeporiginData.archive_files","title":"archive_files  async","text":"
    archive_files(\n    *,\n    file_ids: List[str],\n    extra_headers: Headers | None = None,\n    extra_query: Query | None = None,\n    extra_body: Body | None = None,\n    timeout: float | Timeout | None | NotGiven = NOT_GIVEN\n) -> object\n
     
    Archive files by their ids.
     
    Parameters:
     Name Type Description Default extra_headers Headers | None 
    Send extra headers
     None extra_query Query | None 
    Add additional query parameters to the request
     None extra_body Body | None 
    Add additional JSON properties to the request
     None timeout float | Timeout | None | NotGiven 
    Override the client-level default timeout for this request, in seconds
     NOT_GIVEN"},{"location":"ref/data-hub/low-level-api.html#deeporigin_data._client.AsyncDeeporiginData.chat_create_thread","title":"chat_create_thread  async","text":"
    chat_create_thread(\n    *,\n    body: object,\n    extra_headers: Headers | None = None,\n    extra_query: Query | None = None,\n    extra_body: Body | None = None,\n    timeout: float | Timeout | None | NotGiven = NOT_GIVEN\n) -> ChatCreateThreadResponse\n
     
    Create a new chat thread.
     
    Parameters:
     Name Type Description Default extra_headers Headers | None 
    Send extra headers
     None extra_query Query | None 
    Add additional query parameters to the request
     None extra_body Body | None 
    Add additional JSON properties to the request
     None timeout float | Timeout | None | NotGiven 
    Override the client-level default timeout for this request, in seconds
     NOT_GIVEN"},{"location":"ref/data-hub/low-level-api.html#deeporigin_data._client.AsyncDeeporiginData.chat_list_messages","title":"chat_list_messages  async","text":"
    chat_list_messages(\n    *,\n    thread_id: str,\n    extra_headers: Headers | None = None,\n    extra_query: Query | None = None,\n    extra_body: Body | None = None,\n    timeout: float | Timeout | None | NotGiven = NOT_GIVEN\n) -> ChatListMessagesResponse\n
     
    List messages in a chat thread.
     
    Parameters:
     Name Type Description Default extra_headers Headers | None 
    Send extra headers
     None extra_query Query | None 
    Add additional query parameters to the request
     None extra_body Body | None 
    Add additional JSON properties to the request
     None timeout float | Timeout | None | NotGiven 
    Override the client-level default timeout for this request, in seconds
     NOT_GIVEN"},{"location":"ref/data-hub/low-level-api.html#deeporigin_data._client.AsyncDeeporiginData.chat_send_message","title":"chat_send_message  async","text":"
    chat_send_message(\n    *,\n    messages: Iterable[Message],\n    thread_id: str,\n    context: Context | NotGiven = NOT_GIVEN,\n    extra_headers: Headers | None = None,\n    extra_query: Query | None = None,\n    extra_body: Body | None = None,\n    timeout: float | Timeout | None | NotGiven = NOT_GIVEN\n) -> None\n
     
    Send a chat message to the Deep Origin assistant and streams results via SSE.
     
    Parameters:
     Name Type Description Default extra_headers Headers | None 
    Send extra headers
     None extra_query Query | None 
    Add additional query parameters to the request
     None extra_body Body | None 
    Add additional JSON properties to the request
     None timeout float | Timeout | None | NotGiven 
    Override the client-level default timeout for this request, in seconds
     NOT_GIVEN"},{"location":"ref/data-hub/low-level-api.html#deeporigin_data._client.AsyncDeeporiginData.close","title":"close  async","text":"
    close() -> None\n
     
    Close the underlying HTTPX client.
     
    The client will not be usable after this.
    "},{"location":"ref/data-hub/low-level-api.html#deeporigin_data._client.AsyncDeeporiginData.configure_column_select_options","title":"configure_column_select_options  async","text":"
    configure_column_select_options(\n    *,\n    column_id: str,\n    database_id: str,\n    option_configuration: Iterable[OptionConfiguration],\n    extra_headers: Headers | None = None,\n    extra_query: Query | None = None,\n    extra_body: Body | None = None,\n    timeout: float | Timeout | None | NotGiven = NOT_GIVEN\n) -> ConfigureColumnSelectOptionsResponse\n
     
    Configure column select options.
     
    Supports both adding and removing options.
     
    Parameters:
     Name Type Description Default extra_headers Headers | None 
    Send extra headers
     None extra_query Query | None 
    Add additional query parameters to the request
     None extra_body Body | None 
    Add additional JSON properties to the request
     None timeout float | Timeout | None | NotGiven 
    Override the client-level default timeout for this request, in seconds
     NOT_GIVEN"},{"location":"ref/data-hub/low-level-api.html#deeporigin_data._client.AsyncDeeporiginData.convert_id_format","title":"convert_id_format  async","text":"
    convert_id_format(\n    *,\n    conversions: Iterable[Conversion],\n    extra_headers: Headers | None = None,\n    extra_query: Query | None = None,\n    extra_body: Body | None = None,\n    timeout: float | Timeout | None | NotGiven = NOT_GIVEN\n) -> ConvertIDFormatResponse\n
     
    Converts between system IDs and human IDs (HIDs).
     
    Deprecated - prefer ResolveIds.
     
    Parameters:
     Name Type Description Default extra_headers Headers | None 
    Send extra headers
     None extra_query Query | None 
    Add additional query parameters to the request
     None extra_body Body | None 
    Add additional JSON properties to the request
     None timeout float | Timeout | None | NotGiven 
    Override the client-level default timeout for this request, in seconds
     NOT_GIVEN"},{"location":"ref/data-hub/low-level-api.html#deeporigin_data._client.AsyncDeeporiginData.copy","title":"copy","text":"
    copy(\n    *,\n    token: str | None = None,\n    org_id: str | None = None,\n    base_url: str | URL | None = None,\n    timeout: float | Timeout | None | NotGiven = NOT_GIVEN,\n    http_client: AsyncClient | None = None,\n    max_retries: int | NotGiven = NOT_GIVEN,\n    default_headers: Mapping[str, str] | None = None,\n    set_default_headers: Mapping[str, str] | None = None,\n    default_query: Mapping[str, object] | None = None,\n    set_default_query: Mapping[str, object] | None = None,\n    _extra_kwargs: Mapping[str, Any] = {}\n) -> Self\n
     
    Create a new client instance re-using the same options given to the current client with optional overriding.
    "},{"location":"ref/data-hub/low-level-api.html#deeporigin_data._client.AsyncDeeporiginData.create_database","title":"create_database  async","text":"
    create_database(\n    *,\n    database: Database,\n    extra_headers: Headers | None = None,\n    extra_query: Query | None = None,\n    extra_body: Body | None = None,\n    timeout: float | Timeout | None | NotGiven = NOT_GIVEN\n) -> CreateDatabaseResponse\n
     
    Create a new database.
     
    Parameters:
     Name Type Description Default extra_headers Headers | None 
    Send extra headers
     None extra_query Query | None 
    Add additional query parameters to the request
     None extra_body Body | None 
    Add additional JSON properties to the request
     None timeout float | Timeout | None | NotGiven 
    Override the client-level default timeout for this request, in seconds
     NOT_GIVEN"},{"location":"ref/data-hub/low-level-api.html#deeporigin_data._client.AsyncDeeporiginData.create_file_download_url","title":"create_file_download_url  async","text":"
    create_file_download_url(\n    *,\n    file_id: str,\n    extra_headers: Headers | None = None,\n    extra_query: Query | None = None,\n    extra_body: Body | None = None,\n    timeout: float | Timeout | None | NotGiven = NOT_GIVEN\n) -> CreateFileDownloadURLResponse\n
     
    Returns a pre-signed S3 URL.
     
    Parameters:
     Name Type Description Default file_id str 
    Deep Origin system ID.
     required extra_headers Headers | None 
    Send extra headers
     None extra_query Query | None 
    Add additional query parameters to the request
     None extra_body Body | None 
    Add additional JSON properties to the request
     None timeout float | Timeout | None | NotGiven 
    Override the client-level default timeout for this request, in seconds
     NOT_GIVEN"},{"location":"ref/data-hub/low-level-api.html#deeporigin_data._client.AsyncDeeporiginData.create_file_upload","title":"create_file_upload  async","text":"
    create_file_upload(\n    *,\n    content_length: str,\n    name: str,\n    checksum_sha256: str | NotGiven = NOT_GIVEN,\n    content_type: str | NotGiven = NOT_GIVEN,\n    extra_headers: Headers | None = None,\n    extra_query: Query | None = None,\n    extra_body: Body | None = None,\n    timeout: float | Timeout | None | NotGiven = NOT_GIVEN\n) -> CreateFileUploadResponse\n
     
    Create a file upload URL.
     
    Typically this is creating a pre-signed S3 URL.
     
    Parameters:
     Name Type Description Default checksum_sha256 str | NotGiven 
    Base64 encoded SHA256 checksum of the file.
     NOT_GIVEN extra_headers Headers | None 
    Send extra headers
     None extra_query Query | None 
    Add additional query parameters to the request
     None extra_body Body | None 
    Add additional JSON properties to the request
     None timeout float | Timeout | None | NotGiven 
    Override the client-level default timeout for this request, in seconds
     NOT_GIVEN"},{"location":"ref/data-hub/low-level-api.html#deeporigin_data._client.AsyncDeeporiginData.create_workspace","title":"create_workspace  async","text":"
    create_workspace(\n    *,\n    workspace: Workspace,\n    extra_headers: Headers | None = None,\n    extra_query: Query | None = None,\n    extra_body: Body | None = None,\n    timeout: float | Timeout | None | NotGiven = NOT_GIVEN\n) -> CreateWorkspaceResponse\n
     
    Create a new workspace.
     
    Parameters:
     Name Type Description Default extra_headers Headers | None 
    Send extra headers
     None extra_query Query | None 
    Add additional query parameters to the request
     None extra_body Body | None 
    Add additional JSON properties to the request
     None timeout float | Timeout | None | NotGiven 
    Override the client-level default timeout for this request, in seconds
     NOT_GIVEN"},{"location":"ref/data-hub/low-level-api.html#deeporigin_data._client.AsyncDeeporiginData.delete_database","title":"delete_database  async","text":"
    delete_database(\n    *,\n    database_id: str,\n    extra_headers: Headers | None = None,\n    extra_query: Query | None = None,\n    extra_body: Body | None = None,\n    timeout: float | Timeout | None | NotGiven = NOT_GIVEN\n) -> DeleteDatabaseResponse\n
     
    Permanently deletes a database.
     
    Parameters:
     Name Type Description Default extra_headers Headers | None 
    Send extra headers
     None extra_query Query | None 
    Add additional query parameters to the request
     None extra_body Body | None 
    Add additional JSON properties to the request
     None timeout float | Timeout | None | NotGiven 
    Override the client-level default timeout for this request, in seconds
     NOT_GIVEN"},{"location":"ref/data-hub/low-level-api.html#deeporigin_data._client.AsyncDeeporiginData.delete_database_column","title":"delete_database_column  async","text":"
    delete_database_column(\n    *,\n    column_id: str,\n    database_id: str,\n    extra_headers: Headers | None = None,\n    extra_query: Query | None = None,\n    extra_body: Body | None = None,\n    timeout: float | Timeout | None | NotGiven = NOT_GIVEN\n) -> DeleteDatabaseColumnResponse\n
     
    Delete a column from a database.
     
    Parameters:
     Name Type Description Default extra_headers Headers | None 
    Send extra headers
     None extra_query Query | None 
    Add additional query parameters to the request
     None extra_body Body | None 
    Add additional JSON properties to the request
     None timeout float | Timeout | None | NotGiven 
    Override the client-level default timeout for this request, in seconds
     NOT_GIVEN"},{"location":"ref/data-hub/low-level-api.html#deeporigin_data._client.AsyncDeeporiginData.delete_rows","title":"delete_rows  async","text":"
    delete_rows(\n    *,\n    database_id: str,\n    delete_all: bool | NotGiven = NOT_GIVEN,\n    row_ids: List[str] | NotGiven = NOT_GIVEN,\n    extra_headers: Headers | None = None,\n    extra_query: Query | None = None,\n    extra_body: Body | None = None,\n    timeout: float | Timeout | None | NotGiven = NOT_GIVEN\n) -> DeleteRowsResponse\n
     
    Delete rows by their ids.
     
    Parameters:
     Name Type Description Default delete_all bool | NotGiven 
    When true, deletes all rows in the table except rows with the specified   rowIds.
     NOT_GIVEN row_ids List[str] | NotGiven 
    List of row IDs to delete.
     NOT_GIVEN extra_headers Headers | None 
    Send extra headers
     None extra_query Query | None 
    Add additional query parameters to the request
     None extra_body Body | None 
    Add additional JSON properties to the request
     None timeout float | Timeout | None | NotGiven 
    Override the client-level default timeout for this request, in seconds
     NOT_GIVEN"},{"location":"ref/data-hub/low-level-api.html#deeporigin_data._client.AsyncDeeporiginData.delete_workspace","title":"delete_workspace  async","text":"
    delete_workspace(\n    *,\n    workspace_id: str,\n    extra_headers: Headers | None = None,\n    extra_query: Query | None = None,\n    extra_body: Body | None = None,\n    timeout: float | Timeout | None | NotGiven = NOT_GIVEN\n) -> DeleteWorkspaceResponse\n
     
    Permanently deletes a workspace and all its children.
     
    Parameters:
     Name Type Description Default extra_headers Headers | None 
    Send extra headers
     None extra_query Query | None 
    Add additional query parameters to the request
     None extra_body Body | None 
    Add additional JSON properties to the request
     None timeout float | Timeout | None | NotGiven 
    Override the client-level default timeout for this request, in seconds
     NOT_GIVEN"},{"location":"ref/data-hub/low-level-api.html#deeporigin_data._client.AsyncDeeporiginData.describe_code_execution","title":"describe_code_execution  async","text":"
    describe_code_execution(\n    *,\n    id: str,\n    extra_headers: Headers | None = None,\n    extra_query: Query | None = None,\n    extra_body: Body | None = None,\n    timeout: float | Timeout | None | NotGiven = NOT_GIVEN\n) -> DescribeCodeExecutionResponse\n
     
    Returns information about a particular code execution.
     
    Parameters:
     Name Type Description Default extra_headers Headers | None 
    Send extra headers
     None extra_query Query | None 
    Add additional query parameters to the request
     None extra_body Body | None 
    Add additional JSON properties to the request
     None timeout float | Timeout | None | NotGiven 
    Override the client-level default timeout for this request, in seconds
     NOT_GIVEN"},{"location":"ref/data-hub/low-level-api.html#deeporigin_data._client.AsyncDeeporiginData.describe_database","title":"describe_database  async","text":"
    describe_database(\n    *,\n    database_id: str,\n    extra_headers: Headers | None = None,\n    extra_query: Query | None = None,\n    extra_body: Body | None = None,\n    timeout: float | Timeout | None | NotGiven = NOT_GIVEN\n) -> DescribeDatabaseResponse\n
     
    Describe a database
     
    Parameters:
     Name Type Description Default extra_headers Headers | None 
    Send extra headers
     None extra_query Query | None 
    Add additional query parameters to the request
     None extra_body Body | None 
    Add additional JSON properties to the request
     None timeout float | Timeout | None | NotGiven 
    Override the client-level default timeout for this request, in seconds
     NOT_GIVEN"},{"location":"ref/data-hub/low-level-api.html#deeporigin_data._client.AsyncDeeporiginData.describe_database_row","title":"describe_database_row  async","text":"
    describe_database_row(\n    *,\n    row_id: str,\n    column_selection: (\n        ColumnSelection | NotGiven\n    ) = NOT_GIVEN,\n    database_id: str | NotGiven = NOT_GIVEN,\n    extra_headers: Headers | None = None,\n    extra_query: Query | None = None,\n    extra_body: Body | None = None,\n    timeout: float | Timeout | None | NotGiven = NOT_GIVEN\n) -> DescribeDatabaseRowResponse\n
     
    Describe a database row
     
    Parameters:
     Name Type Description Default column_selection ColumnSelection | NotGiven 
    Select columns for inclusion/exclusion.
     NOT_GIVEN extra_headers Headers | None 
    Send extra headers
     None extra_query Query | None 
    Add additional query parameters to the request
     None extra_body Body | None 
    Add additional JSON properties to the request
     None timeout float | Timeout | None | NotGiven 
    Override the client-level default timeout for this request, in seconds
     NOT_GIVEN"},{"location":"ref/data-hub/low-level-api.html#deeporigin_data._client.AsyncDeeporiginData.describe_database_stats","title":"describe_database_stats  async","text":"
    describe_database_stats(\n    *,\n    database_id: str,\n    extra_headers: Headers | None = None,\n    extra_query: Query | None = None,\n    extra_body: Body | None = None,\n    timeout: float | Timeout | None | NotGiven = NOT_GIVEN\n) -> DescribeDatabaseStatsResponse\n
     
    Returns aggregation information about a particular database.
     
    Parameters:
     Name Type Description Default extra_headers Headers | None 
    Send extra headers
     None extra_query Query | None 
    Add additional query parameters to the request
     None extra_body Body | None 
    Add additional JSON properties to the request
     None timeout float | Timeout | None | NotGiven 
    Override the client-level default timeout for this request, in seconds
     NOT_GIVEN"},{"location":"ref/data-hub/low-level-api.html#deeporigin_data._client.AsyncDeeporiginData.describe_file","title":"describe_file  async","text":"
    describe_file(\n    *,\n    file_id: str,\n    extra_headers: Headers | None = None,\n    extra_query: Query | None = None,\n    extra_body: Body | None = None,\n    timeout: float | Timeout | None | NotGiven = NOT_GIVEN\n) -> DescribeFileResponse\n
     
    Describe a file by its ID.
     
    Parameters:
     Name Type Description Default file_id str 
    Deep Origin system ID.
     required extra_headers Headers | None 
    Send extra headers
     None extra_query Query | None 
    Add additional query parameters to the request
     None extra_body Body | None 
    Add additional JSON properties to the request
     None timeout float | Timeout | None | NotGiven 
    Override the client-level default timeout for this request, in seconds
     NOT_GIVEN"},{"location":"ref/data-hub/low-level-api.html#deeporigin_data._client.AsyncDeeporiginData.describe_hierarchy","title":"describe_hierarchy  async","text":"
    describe_hierarchy(\n    *,\n    id: str,\n    type: Literal[\"database\", \"row\", \"workspace\"],\n    database_id: str | NotGiven = NOT_GIVEN,\n    extra_headers: Headers | None = None,\n    extra_query: Query | None = None,\n    extra_body: Body | None = None,\n    timeout: float | Timeout | None | NotGiven = NOT_GIVEN\n) -> DescribeHierarchyResponse\n
     
    Describe the hierarchical position of an entity.
     
    Parameters:
     Name Type Description Default extra_headers Headers | None 
    Send extra headers
     None extra_query Query | None 
    Add additional query parameters to the request
     None extra_body Body | None 
    Add additional JSON properties to the request
     None timeout float | Timeout | None | NotGiven 
    Override the client-level default timeout for this request, in seconds
     NOT_GIVEN"},{"location":"ref/data-hub/low-level-api.html#deeporigin_data._client.AsyncDeeporiginData.describe_row","title":"describe_row  async","text":"
    describe_row(\n    *,\n    row_id: str,\n    column_selection: (\n        ColumnSelection | NotGiven\n    ) = NOT_GIVEN,\n    fields: bool | NotGiven = NOT_GIVEN,\n    extra_headers: Headers | None = None,\n    extra_query: Query | None = None,\n    extra_body: Body | None = None,\n    timeout: float | Timeout | None | NotGiven = NOT_GIVEN\n) -> DescribeRowResponse\n
     
    Deprecated.
     
    Use DescribeDatabaseRow, DescribeDatabase, or DescribeWorkspace instead.
     
    Parameters:
     Name Type Description Default column_selection ColumnSelection | NotGiven 
    Select columns for inclusion/exclusion.
     NOT_GIVEN extra_headers Headers | None 
    Send extra headers
     None extra_query Query | None 
    Add additional query parameters to the request
     None extra_body Body | None 
    Add additional JSON properties to the request
     None timeout float | Timeout | None | NotGiven 
    Override the client-level default timeout for this request, in seconds
     NOT_GIVEN"},{"location":"ref/data-hub/low-level-api.html#deeporigin_data._client.AsyncDeeporiginData.describe_workspace","title":"describe_workspace  async","text":"
    describe_workspace(\n    *,\n    workspace_id: str,\n    extra_headers: Headers | None = None,\n    extra_query: Query | None = None,\n    extra_body: Body | None = None,\n    timeout: float | Timeout | None | NotGiven = NOT_GIVEN\n) -> DescribeWorkspaceResponse\n
     
    Describe a workspace
     
    Parameters:
     Name Type Description Default extra_headers Headers | None 
    Send extra headers
     None extra_query Query | None 
    Add additional query parameters to the request
     None extra_body Body | None 
    Add additional JSON properties to the request
     None timeout float | Timeout | None | NotGiven 
    Override the client-level default timeout for this request, in seconds
     NOT_GIVEN"},{"location":"ref/data-hub/low-level-api.html#deeporigin_data._client.AsyncDeeporiginData.download_file","title":"download_file  async","text":"
    download_file(\n    *,\n    file_id: str,\n    extra_headers: Headers | None = None,\n    extra_query: Query | None = None,\n    extra_body: Body | None = None,\n    timeout: float | Timeout | None | NotGiven = NOT_GIVEN\n) -> None\n
     
    Returns a 303 redirect to a pre-signed S3 URL.
     
    Parameters:
     Name Type Description Default file_id str 
    Deep Origin system ID.
     required extra_headers Headers | None 
    Send extra headers
     None extra_query Query | None 
    Add additional query parameters to the request
     None extra_body Body | None 
    Add additional JSON properties to the request
     None timeout float | Timeout | None | NotGiven 
    Override the client-level default timeout for this request, in seconds
     NOT_GIVEN"},{"location":"ref/data-hub/low-level-api.html#deeporigin_data._client.AsyncDeeporiginData.ensure_rows","title":"ensure_rows  async","text":"
    ensure_rows(\n    *,\n    database_id: str,\n    rows: Iterable[Row],\n    check_previous_value: bool | NotGiven = NOT_GIVEN,\n    extra_headers: Headers | None = None,\n    extra_query: Query | None = None,\n    extra_body: Body | None = None,\n    timeout: float | Timeout | None | NotGiven = NOT_GIVEN\n) -> EnsureRowsResponse\n
     
    Either creates or updates an existing row.
     
    Supports updates to both system and user defined columns.
     
    Parameters:
     Name Type Description Default extra_headers Headers | None 
    Send extra headers
     None extra_query Query | None 
    Add additional query parameters to the request
     None extra_body Body | None 
    Add additional JSON properties to the request
     None timeout float | Timeout | None | NotGiven 
    Override the client-level default timeout for this request, in seconds
     NOT_GIVEN"},{"location":"ref/data-hub/low-level-api.html#deeporigin_data._client.AsyncDeeporiginData.execute_code_async","title":"execute_code_async  async","text":"
    execute_code_async(\n    *,\n    code: str,\n    code_language: Literal[\"python\"],\n    extra_headers: Headers | None = None,\n    extra_query: Query | None = None,\n    extra_body: Body | None = None,\n    timeout: float | Timeout | None | NotGiven = NOT_GIVEN\n) -> ExecuteCodeAsyncResponse\n
     
    Execute code asynchronously.
     
    Parameters:
     Name Type Description Default extra_headers Headers | None 
    Send extra headers
     None extra_query Query | None 
    Add additional query parameters to the request
     None extra_body Body | None 
    Add additional JSON properties to the request
     None timeout float | Timeout | None | NotGiven 
    Override the client-level default timeout for this request, in seconds
     NOT_GIVEN"},{"location":"ref/data-hub/low-level-api.html#deeporigin_data._client.AsyncDeeporiginData.execute_code_sync","title":"execute_code_sync  async","text":"
    execute_code_sync(\n    *,\n    code: str,\n    code_language: Literal[\"python\"],\n    extra_headers: Headers | None = None,\n    extra_query: Query | None = None,\n    extra_body: Body | None = None,\n    timeout: float | Timeout | None | NotGiven = NOT_GIVEN\n) -> ExecuteCodeSyncResponse\n
     
    Execute code synchronously.
     
    Parameters:
     Name Type Description Default extra_headers Headers | None 
    Send extra headers
     None extra_query Query | None 
    Add additional query parameters to the request
     None extra_body Body | None 
    Add additional JSON properties to the request
     None timeout float | Timeout | None | NotGiven 
    Override the client-level default timeout for this request, in seconds
     NOT_GIVEN"},{"location":"ref/data-hub/low-level-api.html#deeporigin_data._client.AsyncDeeporiginData.export_database","title":"export_database  async","text":"
    export_database(\n    *,\n    database_id: str,\n    format: Literal[\"csv\"],\n    column_selection: (\n        ColumnSelection | NotGiven\n    ) = NOT_GIVEN,\n    filter: Filter | NotGiven = NOT_GIVEN,\n    row_sort: Iterable[RowSort] | NotGiven = NOT_GIVEN,\n    extra_headers: Headers | None = None,\n    extra_query: Query | None = None,\n    extra_body: Body | None = None,\n    timeout: float | Timeout | None | NotGiven = NOT_GIVEN\n) -> AsyncBinaryAPIResponse\n
     
    Exports a database to a file.
     
    Parameters:
     Name Type Description Default column_selection ColumnSelection | NotGiven 
    Select columns for inclusion/exclusion.
     NOT_GIVEN row_sort Iterable[RowSort] | NotGiven 
    Sort rows by column.
     NOT_GIVEN extra_headers Headers | None 
    Send extra headers
     None extra_query Query | None 
    Add additional query parameters to the request
     None extra_body Body | None 
    Add additional JSON properties to the request
     None timeout float | Timeout | None | NotGiven 
    Override the client-level default timeout for this request, in seconds
     NOT_GIVEN"},{"location":"ref/data-hub/low-level-api.html#deeporigin_data._client.AsyncDeeporiginData.get_code_execution_result","title":"get_code_execution_result  async","text":"
    get_code_execution_result(\n    *,\n    id: str,\n    extra_headers: Headers | None = None,\n    extra_query: Query | None = None,\n    extra_body: Body | None = None,\n    timeout: float | Timeout | None | NotGiven = NOT_GIVEN\n) -> object\n
     
    Returns the result of a code execution.
     
    Parameters:
     Name Type Description Default id str 
    Deep Origin system ID.
     required extra_headers Headers | None 
    Send extra headers
     None extra_query Query | None 
    Add additional query parameters to the request
     None extra_body Body | None 
    Add additional JSON properties to the request
     None timeout float | Timeout | None | NotGiven 
    Override the client-level default timeout for this request, in seconds
     NOT_GIVEN"},{"location":"ref/data-hub/low-level-api.html#deeporigin_data._client.AsyncDeeporiginData.import_rows","title":"import_rows  async","text":"
    import_rows(\n    *,\n    database_id: str,\n    add_columns: Iterable[AddColumn] | NotGiven = NOT_GIVEN,\n    creation_block_id: str | NotGiven = NOT_GIVEN,\n    creation_parent_id: str | NotGiven = NOT_GIVEN,\n    extra_headers: Headers | None = None,\n    extra_query: Query | None = None,\n    extra_body: Body | None = None,\n    timeout: float | Timeout | None | NotGiven = NOT_GIVEN\n) -> ImportRowsResponse\n
     
    Creates new rows from CSV data.
     
    Parameters:
     Name Type Description Default add_columns Iterable[AddColumn] | NotGiven 
    Optionally add additional columns to the database during import.
     NOT_GIVEN extra_headers Headers | None 
    Send extra headers
     None extra_query Query | None 
    Add additional query parameters to the request
     None extra_body Body | None 
    Add additional JSON properties to the request
     None timeout float | Timeout | None | NotGiven 
    Override the client-level default timeout for this request, in seconds
     NOT_GIVEN"},{"location":"ref/data-hub/low-level-api.html#deeporigin_data._client.AsyncDeeporiginData.list_database_column_unique_values_v2","title":"list_database_column_unique_values_v2  async","text":"
    list_database_column_unique_values_v2(\n    *,\n    column_id: str,\n    database_id: str,\n    extra_headers: Headers | None = None,\n    extra_query: Query | None = None,\n    extra_body: Body | None = None,\n    timeout: float | Timeout | None | NotGiven = NOT_GIVEN\n) -> ListDatabaseColumnUniqueValuesV2Response\n
     
    Returns the unique values for every cell within the column.
     
    Parameters:
     Name Type Description Default extra_headers Headers | None 
    Send extra headers
     None extra_query Query | None 
    Add additional query parameters to the request
     None extra_body Body | None 
    Add additional JSON properties to the request
     None timeout float | Timeout | None | NotGiven 
    Override the client-level default timeout for this request, in seconds
     NOT_GIVEN"},{"location":"ref/data-hub/low-level-api.html#deeporigin_data._client.AsyncDeeporiginData.list_database_rows","title":"list_database_rows  async","text":"
    list_database_rows(\n    *,\n    database_row_id: str,\n    column_selection: (\n        ColumnSelection | NotGiven\n    ) = NOT_GIVEN,\n    filter: Filter | NotGiven = NOT_GIVEN,\n    limit: int | NotGiven = NOT_GIVEN,\n    offset: int | NotGiven = NOT_GIVEN,\n    row_sort: Iterable[RowSort] | NotGiven = NOT_GIVEN,\n    extra_headers: Headers | None = None,\n    extra_query: Query | None = None,\n    extra_body: Body | None = None,\n    timeout: float | Timeout | None | NotGiven = NOT_GIVEN\n) -> ListDatabaseRowsResponse\n
     
    List database rows with full row data.
     
    Parameters:
     Name Type Description Default column_selection ColumnSelection | NotGiven 
    Select columns for inclusion/exclusion.
     NOT_GIVEN row_sort Iterable[RowSort] | NotGiven 
    Sort rows by column.
     NOT_GIVEN extra_headers Headers | None 
    Send extra headers
     None extra_query Query | None 
    Add additional query parameters to the request
     None extra_body Body | None 
    Add additional JSON properties to the request
     None timeout float | Timeout | None | NotGiven 
    Override the client-level default timeout for this request, in seconds
     NOT_GIVEN"},{"location":"ref/data-hub/low-level-api.html#deeporigin_data._client.AsyncDeeporiginData.list_files","title":"list_files  async","text":"
    list_files(\n    *,\n    filters: Iterable[Filter] | NotGiven = NOT_GIVEN,\n    extra_headers: Headers | None = None,\n    extra_query: Query | None = None,\n    extra_body: Body | None = None,\n    timeout: float | Timeout | None | NotGiven = NOT_GIVEN\n) -> ListFilesResponse\n
     
    Returns a list of files using the filters.
     
    Parameters:
     Name Type Description Default extra_headers Headers | None 
    Send extra headers
     None extra_query Query | None 
    Add additional query parameters to the request
     None extra_body Body | None 
    Add additional JSON properties to the request
     None timeout float | Timeout | None | NotGiven 
    Override the client-level default timeout for this request, in seconds
     NOT_GIVEN"},{"location":"ref/data-hub/low-level-api.html#deeporigin_data._client.AsyncDeeporiginData.list_mentions","title":"list_mentions  async","text":"
    list_mentions(\n    *,\n    query: str,\n    extra_headers: Headers | None = None,\n    extra_query: Query | None = None,\n    extra_body: Body | None = None,\n    timeout: float | Timeout | None | NotGiven = NOT_GIVEN\n) -> ListMentionsResponse\n
     
    Returns entities that can be mentioned in a notebook.
     
    Parameters:
     Name Type Description Default extra_headers Headers | None 
    Send extra headers
     None extra_query Query | None 
    Add additional query parameters to the request
     None extra_body Body | None 
    Add additional JSON properties to the request
     None timeout float | Timeout | None | NotGiven 
    Override the client-level default timeout for this request, in seconds
     NOT_GIVEN"},{"location":"ref/data-hub/low-level-api.html#deeporigin_data._client.AsyncDeeporiginData.list_row_back_references","title":"list_row_back_references  async","text":"
    list_row_back_references(\n    *,\n    database_id: str,\n    row_id: str,\n    extra_headers: Headers | None = None,\n    extra_query: Query | None = None,\n    extra_body: Body | None = None,\n    timeout: float | Timeout | None | NotGiven = NOT_GIVEN\n) -> ListRowBackReferencesResponse\n
     
    Finds all the places a row is referenced.
     
    Parameters:
     Name Type Description Default extra_headers Headers | None 
    Send extra headers
     None extra_query Query | None 
    Add additional query parameters to the request
     None extra_body Body | None 
    Add additional JSON properties to the request
     None timeout float | Timeout | None | NotGiven 
    Override the client-level default timeout for this request, in seconds
     NOT_GIVEN"},{"location":"ref/data-hub/low-level-api.html#deeporigin_data._client.AsyncDeeporiginData.list_rows","title":"list_rows  async","text":"
    list_rows(\n    *,\n    filters: Iterable[Filter],\n    extra_headers: Headers | None = None,\n    extra_query: Query | None = None,\n    extra_body: Body | None = None,\n    timeout: float | Timeout | None | NotGiven = NOT_GIVEN\n) -> ListRowsResponse\n
     
    Lists rows at a given depth in the hierarchy.
     
    Parameters:
     Name Type Description Default extra_headers Headers | None 
    Send extra headers
     None extra_query Query | None 
    Add additional query parameters to the request
     None extra_body Body | None 
    Add additional JSON properties to the request
     None timeout float | Timeout | None | NotGiven 
    Override the client-level default timeout for this request, in seconds
     NOT_GIVEN"},{"location":"ref/data-hub/low-level-api.html#deeporigin_data._client.AsyncDeeporiginData.lock_database","title":"lock_database  async","text":"
    lock_database(\n    *,\n    database_id: str,\n    extra_headers: Headers | None = None,\n    extra_query: Query | None = None,\n    extra_body: Body | None = None,\n    timeout: float | Timeout | None | NotGiven = NOT_GIVEN\n) -> LockDatabaseResponse\n
     
    A locked database cannot be edited.
     
    Parameters:
     Name Type Description Default extra_headers Headers | None 
    Send extra headers
     None extra_query Query | None 
    Add additional query parameters to the request
     None extra_body Body | None 
    Add additional JSON properties to the request
     None timeout float | Timeout | None | NotGiven 
    Override the client-level default timeout for this request, in seconds
     NOT_GIVEN"},{"location":"ref/data-hub/low-level-api.html#deeporigin_data._client.AsyncDeeporiginData.parse_base_sequence_data","title":"parse_base_sequence_data  async","text":"
    parse_base_sequence_data(\n    *,\n    file_id: str,\n    extra_headers: Headers | None = None,\n    extra_query: Query | None = None,\n    extra_body: Body | None = None,\n    timeout: float | Timeout | None | NotGiven = NOT_GIVEN\n) -> ParseBaseSequenceDataResponse\n
     
    Parses a base sequence file and returns the parsed result.
     
    Parameters:
     Name Type Description Default extra_headers Headers | None 
    Send extra headers
     None extra_query Query | None 
    Add additional query parameters to the request
     None extra_body Body | None 
    Add additional JSON properties to the request
     None timeout float | Timeout | None | NotGiven 
    Override the client-level default timeout for this request, in seconds
     NOT_GIVEN"},{"location":"ref/data-hub/low-level-api.html#deeporigin_data._client.AsyncDeeporiginData.resolve_ids","title":"resolve_ids  async","text":"
    resolve_ids(\n    *,\n    database_ids: List[str] | NotGiven = NOT_GIVEN,\n    rows: Iterable[Row] | NotGiven = NOT_GIVEN,\n    workspace_ids: List[str] | NotGiven = NOT_GIVEN,\n    extra_headers: Headers | None = None,\n    extra_query: Query | None = None,\n    extra_body: Body | None = None,\n    timeout: float | Timeout | None | NotGiven = NOT_GIVEN\n) -> ResolveIDsResponse\n
     
    Resolves between system IDs and human IDs (HIDs).
     
    Parameters:
     Name Type Description Default extra_headers Headers | None 
    Send extra headers
     None extra_query Query | None 
    Add additional query parameters to the request
     None extra_body Body | None 
    Add additional JSON properties to the request
     None timeout float | Timeout | None | NotGiven 
    Override the client-level default timeout for this request, in seconds
     NOT_GIVEN"},{"location":"ref/data-hub/low-level-api.html#deeporigin_data._client.AsyncDeeporiginData.unlock_database","title":"unlock_database  async","text":"
    unlock_database(\n    *,\n    database_id: str,\n    extra_headers: Headers | None = None,\n    extra_query: Query | None = None,\n    extra_body: Body | None = None,\n    timeout: float | Timeout | None | NotGiven = NOT_GIVEN\n) -> UnlockDatabaseResponse\n
     
    An unlocked database can be edited.
     
    Parameters:
     Name Type Description Default extra_headers Headers | None 
    Send extra headers
     None extra_query Query | None 
    Add additional query parameters to the request
     None extra_body Body | None 
    Add additional JSON properties to the request
     None timeout float | Timeout | None | NotGiven 
    Override the client-level default timeout for this request, in seconds
     NOT_GIVEN"},{"location":"ref/data-hub/low-level-api.html#deeporigin_data._client.AsyncDeeporiginData.update_database","title":"update_database  async","text":"
    update_database(\n    *,\n    id: str,\n    database: Database,\n    extra_headers: Headers | None = None,\n    extra_query: Query | None = None,\n    extra_body: Body | None = None,\n    timeout: float | Timeout | None | NotGiven = NOT_GIVEN\n) -> UpdateDatabaseResponse\n
     
    Update a database.
     
    Parameters:
     Name Type Description Default extra_headers Headers | None 
    Send extra headers
     None extra_query Query | None 
    Add additional query parameters to the request
     None extra_body Body | None 
    Add additional JSON properties to the request
     None timeout float | Timeout | None | NotGiven 
    Override the client-level default timeout for this request, in seconds
     NOT_GIVEN"},{"location":"ref/data-hub/low-level-api.html#deeporigin_data._client.AsyncDeeporiginData.update_database_column","title":"update_database_column  async","text":"
    update_database_column(\n    *,\n    column: Column,\n    column_id: str,\n    database_id: str,\n    extra_headers: Headers | None = None,\n    extra_query: Query | None = None,\n    extra_body: Body | None = None,\n    timeout: float | Timeout | None | NotGiven = NOT_GIVEN\n) -> UpdateDatabaseColumnResponse\n
     
    Update a column in a database.
     
    Parameters:
     Name Type Description Default extra_headers Headers | None 
    Send extra headers
     None extra_query Query | None 
    Add additional query parameters to the request
     None extra_body Body | None 
    Add additional JSON properties to the request
     None timeout float | Timeout | None | NotGiven 
    Override the client-level default timeout for this request, in seconds
     NOT_GIVEN"},{"location":"ref/data-hub/low-level-api.html#deeporigin_data._client.AsyncDeeporiginData.update_workspace","title":"update_workspace  async","text":"
    update_workspace(\n    *,\n    id: str,\n    workspace: Workspace,\n    extra_headers: Headers | None = None,\n    extra_query: Query | None = None,\n    extra_body: Body | None = None,\n    timeout: float | Timeout | None | NotGiven = NOT_GIVEN\n) -> UpdateWorkspaceResponse\n
     
    Update a workspace.
     
    Parameters:
     Name Type Description Default extra_headers Headers | None 
    Send extra headers
     None extra_query Query | None 
    Add additional query parameters to the request
     None extra_body Body | None 
    Add additional JSON properties to the request
     None timeout float | Timeout | None | NotGiven 
    Override the client-level default timeout for this request, in seconds
     NOT_GIVEN"},{"location":"ref/data-hub/low-level-api.html#deeporigin_data._client.DeeporiginData","title":"DeeporiginData","text":"
                   Bases: SyncAPIClient
    "},{"location":"ref/data-hub/low-level-api.html#deeporigin_data._client.DeeporiginData.__init__","title":"__init__","text":"
    __init__(\n    *,\n    token: str | None = None,\n    org_id: str | None = None,\n    base_url: str | URL | None = None,\n    timeout: Union[\n        float, Timeout, None, NotGiven\n    ] = NOT_GIVEN,\n    max_retries: int = DEFAULT_MAX_RETRIES,\n    default_headers: Mapping[str, str] | None = None,\n    default_query: Mapping[str, object] | None = None,\n    http_client: Client | None = None,\n    _strict_response_validation: bool = False\n) -> None\n
     
    This automatically infers the following arguments from their corresponding environment variables if they are not provided: - token from ORG_BEARER_TOKEN - org_id from ORG_ID
    "},{"location":"ref/data-hub/low-level-api.html#deeporigin_data._client.DeeporiginData.add_database_column","title":"add_database_column","text":"
    add_database_column(\n    *,\n    column: Column,\n    database_id: str,\n    extra_headers: Headers | None = None,\n    extra_query: Query | None = None,\n    extra_body: Body | None = None,\n    timeout: float | Timeout | None | NotGiven = NOT_GIVEN\n) -> AddDatabaseColumnResponse\n
     
    Add a column to a database.
     
    Parameters:
     Name Type Description Default extra_headers Headers | None 
    Send extra headers
     None extra_query Query | None 
    Add additional query parameters to the request
     None extra_body Body | None 
    Add additional JSON properties to the request
     None timeout float | Timeout | None | NotGiven 
    Override the client-level default timeout for this request, in seconds
     NOT_GIVEN"},{"location":"ref/data-hub/low-level-api.html#deeporigin_data._client.DeeporiginData.archive_files","title":"archive_files","text":"
    archive_files(\n    *,\n    file_ids: List[str],\n    extra_headers: Headers | None = None,\n    extra_query: Query | None = None,\n    extra_body: Body | None = None,\n    timeout: float | Timeout | None | NotGiven = NOT_GIVEN\n) -> object\n
     
    Archive files by their ids.
     
    Parameters:
     Name Type Description Default extra_headers Headers | None 
    Send extra headers
     None extra_query Query | None 
    Add additional query parameters to the request
     None extra_body Body | None 
    Add additional JSON properties to the request
     None timeout float | Timeout | None | NotGiven 
    Override the client-level default timeout for this request, in seconds
     NOT_GIVEN"},{"location":"ref/data-hub/low-level-api.html#deeporigin_data._client.DeeporiginData.chat_create_thread","title":"chat_create_thread","text":"
    chat_create_thread(\n    *,\n    body: object,\n    extra_headers: Headers | None = None,\n    extra_query: Query | None = None,\n    extra_body: Body | None = None,\n    timeout: float | Timeout | None | NotGiven = NOT_GIVEN\n) -> ChatCreateThreadResponse\n
     
    Create a new chat thread.
     
    Parameters:
     Name Type Description Default extra_headers Headers | None 
    Send extra headers
     None extra_query Query | None 
    Add additional query parameters to the request
     None extra_body Body | None 
    Add additional JSON properties to the request
     None timeout float | Timeout | None | NotGiven 
    Override the client-level default timeout for this request, in seconds
     NOT_GIVEN"},{"location":"ref/data-hub/low-level-api.html#deeporigin_data._client.DeeporiginData.chat_list_messages","title":"chat_list_messages","text":"
    chat_list_messages(\n    *,\n    thread_id: str,\n    extra_headers: Headers | None = None,\n    extra_query: Query | None = None,\n    extra_body: Body | None = None,\n    timeout: float | Timeout | None | NotGiven = NOT_GIVEN\n) -> ChatListMessagesResponse\n
     
    List messages in a chat thread.
     
    Parameters:
     Name Type Description Default extra_headers Headers | None 
    Send extra headers
     None extra_query Query | None 
    Add additional query parameters to the request
     None extra_body Body | None 
    Add additional JSON properties to the request
     None timeout float | Timeout | None | NotGiven 
    Override the client-level default timeout for this request, in seconds
     NOT_GIVEN"},{"location":"ref/data-hub/low-level-api.html#deeporigin_data._client.DeeporiginData.chat_send_message","title":"chat_send_message","text":"
    chat_send_message(\n    *,\n    messages: Iterable[Message],\n    thread_id: str,\n    context: Context | NotGiven = NOT_GIVEN,\n    extra_headers: Headers | None = None,\n    extra_query: Query | None = None,\n    extra_body: Body | None = None,\n    timeout: float | Timeout | None | NotGiven = NOT_GIVEN\n) -> None\n
     
    Send a chat message to the Deep Origin assistant and streams results via SSE.
     
    Parameters:
     Name Type Description Default extra_headers Headers | None 
    Send extra headers
     None extra_query Query | None 
    Add additional query parameters to the request
     None extra_body Body | None 
    Add additional JSON properties to the request
     None timeout float | Timeout | None | NotGiven 
    Override the client-level default timeout for this request, in seconds
     NOT_GIVEN"},{"location":"ref/data-hub/low-level-api.html#deeporigin_data._client.DeeporiginData.close","title":"close","text":"
    close() -> None\n
     
    Close the underlying HTTPX client.
     
    The client will not be usable after this.
    "},{"location":"ref/data-hub/low-level-api.html#deeporigin_data._client.DeeporiginData.configure_column_select_options","title":"configure_column_select_options","text":"
    configure_column_select_options(\n    *,\n    column_id: str,\n    database_id: str,\n    option_configuration: Iterable[OptionConfiguration],\n    extra_headers: Headers | None = None,\n    extra_query: Query | None = None,\n    extra_body: Body | None = None,\n    timeout: float | Timeout | None | NotGiven = NOT_GIVEN\n) -> ConfigureColumnSelectOptionsResponse\n
     
    Configure column select options.
     
    Supports both adding and removing options.
     
    Parameters:
     Name Type Description Default extra_headers Headers | None 
    Send extra headers
     None extra_query Query | None 
    Add additional query parameters to the request
     None extra_body Body | None 
    Add additional JSON properties to the request
     None timeout float | Timeout | None | NotGiven 
    Override the client-level default timeout for this request, in seconds
     NOT_GIVEN"},{"location":"ref/data-hub/low-level-api.html#deeporigin_data._client.DeeporiginData.convert_id_format","title":"convert_id_format","text":"
    convert_id_format(\n    *,\n    conversions: Iterable[Conversion],\n    extra_headers: Headers | None = None,\n    extra_query: Query | None = None,\n    extra_body: Body | None = None,\n    timeout: float | Timeout | None | NotGiven = NOT_GIVEN\n) -> ConvertIDFormatResponse\n
     
    Converts between system IDs and human IDs (HIDs).
     
    Deprecated - prefer ResolveIds.
     
    Parameters:
     Name Type Description Default extra_headers Headers | None 
    Send extra headers
     None extra_query Query | None 
    Add additional query parameters to the request
     None extra_body Body | None 
    Add additional JSON properties to the request
     None timeout float | Timeout | None | NotGiven 
    Override the client-level default timeout for this request, in seconds
     NOT_GIVEN"},{"location":"ref/data-hub/low-level-api.html#deeporigin_data._client.DeeporiginData.copy","title":"copy","text":"
    copy(\n    *,\n    token: str | None = None,\n    org_id: str | None = None,\n    base_url: str | URL | None = None,\n    timeout: float | Timeout | None | NotGiven = NOT_GIVEN,\n    http_client: Client | None = None,\n    max_retries: int | NotGiven = NOT_GIVEN,\n    default_headers: Mapping[str, str] | None = None,\n    set_default_headers: Mapping[str, str] | None = None,\n    default_query: Mapping[str, object] | None = None,\n    set_default_query: Mapping[str, object] | None = None,\n    _extra_kwargs: Mapping[str, Any] = {}\n) -> Self\n
     
    Create a new client instance re-using the same options given to the current client with optional overriding.
    "},{"location":"ref/data-hub/low-level-api.html#deeporigin_data._client.DeeporiginData.create_database","title":"create_database","text":"
    create_database(\n    *,\n    database: Database,\n    extra_headers: Headers | None = None,\n    extra_query: Query | None = None,\n    extra_body: Body | None = None,\n    timeout: float | Timeout | None | NotGiven = NOT_GIVEN\n) -> CreateDatabaseResponse\n
     
    Create a new database.
     
    Parameters:
     Name Type Description Default extra_headers Headers | None 
    Send extra headers
     None extra_query Query | None 
    Add additional query parameters to the request
     None extra_body Body | None 
    Add additional JSON properties to the request
     None timeout float | Timeout | None | NotGiven 
    Override the client-level default timeout for this request, in seconds
     NOT_GIVEN"},{"location":"ref/data-hub/low-level-api.html#deeporigin_data._client.DeeporiginData.create_file_download_url","title":"create_file_download_url","text":"
    create_file_download_url(\n    *,\n    file_id: str,\n    extra_headers: Headers | None = None,\n    extra_query: Query | None = None,\n    extra_body: Body | None = None,\n    timeout: float | Timeout | None | NotGiven = NOT_GIVEN\n) -> CreateFileDownloadURLResponse\n
     
    Returns a pre-signed S3 URL.
     
    Parameters:
     Name Type Description Default file_id str 
    Deep Origin system ID.
     required extra_headers Headers | None 
    Send extra headers
     None extra_query Query | None 
    Add additional query parameters to the request
     None extra_body Body | None 
    Add additional JSON properties to the request
     None timeout float | Timeout | None | NotGiven 
    Override the client-level default timeout for this request, in seconds
     NOT_GIVEN"},{"location":"ref/data-hub/low-level-api.html#deeporigin_data._client.DeeporiginData.create_file_upload","title":"create_file_upload","text":"
    create_file_upload(\n    *,\n    content_length: str,\n    name: str,\n    checksum_sha256: str | NotGiven = NOT_GIVEN,\n    content_type: str | NotGiven = NOT_GIVEN,\n    extra_headers: Headers | None = None,\n    extra_query: Query | None = None,\n    extra_body: Body | None = None,\n    timeout: float | Timeout | None | NotGiven = NOT_GIVEN\n) -> CreateFileUploadResponse\n
     
    Create a file upload URL.
     
    Typically this is creating a pre-signed S3 URL.
     
    Parameters:
     Name Type Description Default checksum_sha256 str | NotGiven 
    Base64 encoded SHA256 checksum of the file.
     NOT_GIVEN extra_headers Headers | None 
    Send extra headers
     None extra_query Query | None 
    Add additional query parameters to the request
     None extra_body Body | None 
    Add additional JSON properties to the request
     None timeout float | Timeout | None | NotGiven 
    Override the client-level default timeout for this request, in seconds
     NOT_GIVEN"},{"location":"ref/data-hub/low-level-api.html#deeporigin_data._client.DeeporiginData.create_workspace","title":"create_workspace","text":"
    create_workspace(\n    *,\n    workspace: Workspace,\n    extra_headers: Headers | None = None,\n    extra_query: Query | None = None,\n    extra_body: Body | None = None,\n    timeout: float | Timeout | None | NotGiven = NOT_GIVEN\n) -> CreateWorkspaceResponse\n
     
    Create a new workspace.
     
    Parameters:
     Name Type Description Default extra_headers Headers | None 
    Send extra headers
     None extra_query Query | None 
    Add additional query parameters to the request
     None extra_body Body | None 
    Add additional JSON properties to the request
     None timeout float | Timeout | None | NotGiven 
    Override the client-level default timeout for this request, in seconds
     NOT_GIVEN"},{"location":"ref/data-hub/low-level-api.html#deeporigin_data._client.DeeporiginData.delete_database","title":"delete_database","text":"
    delete_database(\n    *,\n    database_id: str,\n    extra_headers: Headers | None = None,\n    extra_query: Query | None = None,\n    extra_body: Body | None = None,\n    timeout: float | Timeout | None | NotGiven = NOT_GIVEN\n) -> DeleteDatabaseResponse\n
     
    Permanently deletes a database.
     
    Parameters:
     Name Type Description Default extra_headers Headers | None 
    Send extra headers
     None extra_query Query | None 
    Add additional query parameters to the request
     None extra_body Body | None 
    Add additional JSON properties to the request
     None timeout float | Timeout | None | NotGiven 
    Override the client-level default timeout for this request, in seconds
     NOT_GIVEN"},{"location":"ref/data-hub/low-level-api.html#deeporigin_data._client.DeeporiginData.delete_database_column","title":"delete_database_column","text":"
    delete_database_column(\n    *,\n    column_id: str,\n    database_id: str,\n    extra_headers: Headers | None = None,\n    extra_query: Query | None = None,\n    extra_body: Body | None = None,\n    timeout: float | Timeout | None | NotGiven = NOT_GIVEN\n) -> DeleteDatabaseColumnResponse\n
     
    Delete a column from a database.
     
    Parameters:
     Name Type Description Default extra_headers Headers | None 
    Send extra headers
     None extra_query Query | None 
    Add additional query parameters to the request
     None extra_body Body | None 
    Add additional JSON properties to the request
     None timeout float | Timeout | None | NotGiven 
    Override the client-level default timeout for this request, in seconds
     NOT_GIVEN"},{"location":"ref/data-hub/low-level-api.html#deeporigin_data._client.DeeporiginData.delete_rows","title":"delete_rows","text":"
    delete_rows(\n    *,\n    database_id: str,\n    delete_all: bool | NotGiven = NOT_GIVEN,\n    row_ids: List[str] | NotGiven = NOT_GIVEN,\n    extra_headers: Headers | None = None,\n    extra_query: Query | None = None,\n    extra_body: Body | None = None,\n    timeout: float | Timeout | None | NotGiven = NOT_GIVEN\n) -> DeleteRowsResponse\n
     
    Delete rows by their ids.
     
    Parameters:
     Name Type Description Default delete_all bool | NotGiven 
    When true, deletes all rows in the table except rows with the specified   rowIds.
     NOT_GIVEN row_ids List[str] | NotGiven 
    List of row IDs to delete.
     NOT_GIVEN extra_headers Headers | None 
    Send extra headers
     None extra_query Query | None 
    Add additional query parameters to the request
     None extra_body Body | None 
    Add additional JSON properties to the request
     None timeout float | Timeout | None | NotGiven 
    Override the client-level default timeout for this request, in seconds
     NOT_GIVEN"},{"location":"ref/data-hub/low-level-api.html#deeporigin_data._client.DeeporiginData.delete_workspace","title":"delete_workspace","text":"
    delete_workspace(\n    *,\n    workspace_id: str,\n    extra_headers: Headers | None = None,\n    extra_query: Query | None = None,\n    extra_body: Body | None = None,\n    timeout: float | Timeout | None | NotGiven = NOT_GIVEN\n) -> DeleteWorkspaceResponse\n
     
    Permanently deletes a workspace and all its children.
     
    Parameters:
     Name Type Description Default extra_headers Headers | None 
    Send extra headers
     None extra_query Query | None 
    Add additional query parameters to the request
     None extra_body Body | None 
    Add additional JSON properties to the request
     None timeout float | Timeout | None | NotGiven 
    Override the client-level default timeout for this request, in seconds
     NOT_GIVEN"},{"location":"ref/data-hub/low-level-api.html#deeporigin_data._client.DeeporiginData.describe_code_execution","title":"describe_code_execution","text":"
    describe_code_execution(\n    *,\n    id: str,\n    extra_headers: Headers | None = None,\n    extra_query: Query | None = None,\n    extra_body: Body | None = None,\n    timeout: float | Timeout | None | NotGiven = NOT_GIVEN\n) -> DescribeCodeExecutionResponse\n
     
    Returns information about a particular code execution.
     
    Parameters:
     Name Type Description Default extra_headers Headers | None 
    Send extra headers
     None extra_query Query | None 
    Add additional query parameters to the request
     None extra_body Body | None 
    Add additional JSON properties to the request
     None timeout float | Timeout | None | NotGiven 
    Override the client-level default timeout for this request, in seconds
     NOT_GIVEN"},{"location":"ref/data-hub/low-level-api.html#deeporigin_data._client.DeeporiginData.describe_database","title":"describe_database","text":"
    describe_database(\n    *,\n    database_id: str,\n    extra_headers: Headers | None = None,\n    extra_query: Query | None = None,\n    extra_body: Body | None = None,\n    timeout: float | Timeout | None | NotGiven = NOT_GIVEN\n) -> DescribeDatabaseResponse\n
     
    Describe a database
     
    Parameters:
     Name Type Description Default extra_headers Headers | None 
    Send extra headers
     None extra_query Query | None 
    Add additional query parameters to the request
     None extra_body Body | None 
    Add additional JSON properties to the request
     None timeout float | Timeout | None | NotGiven 
    Override the client-level default timeout for this request, in seconds
     NOT_GIVEN"},{"location":"ref/data-hub/low-level-api.html#deeporigin_data._client.DeeporiginData.describe_database_row","title":"describe_database_row","text":"
    describe_database_row(\n    *,\n    row_id: str,\n    column_selection: (\n        ColumnSelection | NotGiven\n    ) = NOT_GIVEN,\n    database_id: str | NotGiven = NOT_GIVEN,\n    extra_headers: Headers | None = None,\n    extra_query: Query | None = None,\n    extra_body: Body | None = None,\n    timeout: float | Timeout | None | NotGiven = NOT_GIVEN\n) -> DescribeDatabaseRowResponse\n
     
    Describe a database row
     
    Parameters:
     Name Type Description Default column_selection ColumnSelection | NotGiven 
    Select columns for inclusion/exclusion.
     NOT_GIVEN extra_headers Headers | None 
    Send extra headers
     None extra_query Query | None 
    Add additional query parameters to the request
     None extra_body Body | None 
    Add additional JSON properties to the request
     None timeout float | Timeout | None | NotGiven 
    Override the client-level default timeout for this request, in seconds
     NOT_GIVEN"},{"location":"ref/data-hub/low-level-api.html#deeporigin_data._client.DeeporiginData.describe_database_stats","title":"describe_database_stats","text":"
    describe_database_stats(\n    *,\n    database_id: str,\n    extra_headers: Headers | None = None,\n    extra_query: Query | None = None,\n    extra_body: Body | None = None,\n    timeout: float | Timeout | None | NotGiven = NOT_GIVEN\n) -> DescribeDatabaseStatsResponse\n
     
    Returns aggregation information about a particular database.
     
    Parameters:
     Name Type Description Default extra_headers Headers | None 
    Send extra headers
     None extra_query Query | None 
    Add additional query parameters to the request
     None extra_body Body | None 
    Add additional JSON properties to the request
     None timeout float | Timeout | None | NotGiven 
    Override the client-level default timeout for this request, in seconds
     NOT_GIVEN"},{"location":"ref/data-hub/low-level-api.html#deeporigin_data._client.DeeporiginData.describe_file","title":"describe_file","text":"
    describe_file(\n    *,\n    file_id: str,\n    extra_headers: Headers | None = None,\n    extra_query: Query | None = None,\n    extra_body: Body | None = None,\n    timeout: float | Timeout | None | NotGiven = NOT_GIVEN\n) -> DescribeFileResponse\n
     
    Describe a file by its ID.
     
    Parameters:
     Name Type Description Default file_id str 
    Deep Origin system ID.
     required extra_headers Headers | None 
    Send extra headers
     None extra_query Query | None 
    Add additional query parameters to the request
     None extra_body Body | None 
    Add additional JSON properties to the request
     None timeout float | Timeout | None | NotGiven 
    Override the client-level default timeout for this request, in seconds
     NOT_GIVEN"},{"location":"ref/data-hub/low-level-api.html#deeporigin_data._client.DeeporiginData.describe_hierarchy","title":"describe_hierarchy","text":"
    describe_hierarchy(\n    *,\n    id: str,\n    type: Literal[\"database\", \"row\", \"workspace\"],\n    database_id: str | NotGiven = NOT_GIVEN,\n    extra_headers: Headers | None = None,\n    extra_query: Query | None = None,\n    extra_body: Body | None = None,\n    timeout: float | Timeout | None | NotGiven = NOT_GIVEN\n) -> DescribeHierarchyResponse\n
     
    Describe the hierarchical position of an entity.
     
    Parameters:
     Name Type Description Default extra_headers Headers | None 
    Send extra headers
     None extra_query Query | None 
    Add additional query parameters to the request
     None extra_body Body | None 
    Add additional JSON properties to the request
     None timeout float | Timeout | None | NotGiven 
    Override the client-level default timeout for this request, in seconds
     NOT_GIVEN"},{"location":"ref/data-hub/low-level-api.html#deeporigin_data._client.DeeporiginData.describe_row","title":"describe_row","text":"
    describe_row(\n    *,\n    row_id: str,\n    column_selection: (\n        ColumnSelection | NotGiven\n    ) = NOT_GIVEN,\n    fields: bool | NotGiven = NOT_GIVEN,\n    extra_headers: Headers | None = None,\n    extra_query: Query | None = None,\n    extra_body: Body | None = None,\n    timeout: float | Timeout | None | NotGiven = NOT_GIVEN\n) -> DescribeRowResponse\n
     
    Deprecated.
     
    Use DescribeDatabaseRow, DescribeDatabase, or DescribeWorkspace instead.
     
    Parameters:
     Name Type Description Default column_selection ColumnSelection | NotGiven 
    Select columns for inclusion/exclusion.
     NOT_GIVEN extra_headers Headers | None 
    Send extra headers
     None extra_query Query | None 
    Add additional query parameters to the request
     None extra_body Body | None 
    Add additional JSON properties to the request
     None timeout float | Timeout | None | NotGiven 
    Override the client-level default timeout for this request, in seconds
     NOT_GIVEN"},{"location":"ref/data-hub/low-level-api.html#deeporigin_data._client.DeeporiginData.describe_workspace","title":"describe_workspace","text":"
    describe_workspace(\n    *,\n    workspace_id: str,\n    extra_headers: Headers | None = None,\n    extra_query: Query | None = None,\n    extra_body: Body | None = None,\n    timeout: float | Timeout | None | NotGiven = NOT_GIVEN\n) -> DescribeWorkspaceResponse\n
     
    Describe a workspace
     
    Parameters:
     Name Type Description Default extra_headers Headers | None 
    Send extra headers
     None extra_query Query | None 
    Add additional query parameters to the request
     None extra_body Body | None 
    Add additional JSON properties to the request
     None timeout float | Timeout | None | NotGiven 
    Override the client-level default timeout for this request, in seconds
     NOT_GIVEN"},{"location":"ref/data-hub/low-level-api.html#deeporigin_data._client.DeeporiginData.download_file","title":"download_file","text":"
    download_file(\n    *,\n    file_id: str,\n    extra_headers: Headers | None = None,\n    extra_query: Query | None = None,\n    extra_body: Body | None = None,\n    timeout: float | Timeout | None | NotGiven = NOT_GIVEN\n) -> None\n
     
    Returns a 303 redirect to a pre-signed S3 URL.
     
    Parameters:
     Name Type Description Default file_id str 
    Deep Origin system ID.
     required extra_headers Headers | None 
    Send extra headers
     None extra_query Query | None 
    Add additional query parameters to the request
     None extra_body Body | None 
    Add additional JSON properties to the request
     None timeout float | Timeout | None | NotGiven 
    Override the client-level default timeout for this request, in seconds
     NOT_GIVEN"},{"location":"ref/data-hub/low-level-api.html#deeporigin_data._client.DeeporiginData.ensure_rows","title":"ensure_rows","text":"
    ensure_rows(\n    *,\n    database_id: str,\n    rows: Iterable[Row],\n    check_previous_value: bool | NotGiven = NOT_GIVEN,\n    extra_headers: Headers | None = None,\n    extra_query: Query | None = None,\n    extra_body: Body | None = None,\n    timeout: float | Timeout | None | NotGiven = NOT_GIVEN\n) -> EnsureRowsResponse\n
     
    Either creates or updates an existing row.
     
    Supports updates to both system and user defined columns.
     
    Parameters:
     Name Type Description Default extra_headers Headers | None 
    Send extra headers
     None extra_query Query | None 
    Add additional query parameters to the request
     None extra_body Body | None 
    Add additional JSON properties to the request
     None timeout float | Timeout | None | NotGiven 
    Override the client-level default timeout for this request, in seconds
     NOT_GIVEN"},{"location":"ref/data-hub/low-level-api.html#deeporigin_data._client.DeeporiginData.execute_code_async","title":"execute_code_async","text":"
    execute_code_async(\n    *,\n    code: str,\n    code_language: Literal[\"python\"],\n    extra_headers: Headers | None = None,\n    extra_query: Query | None = None,\n    extra_body: Body | None = None,\n    timeout: float | Timeout | None | NotGiven = NOT_GIVEN\n) -> ExecuteCodeAsyncResponse\n
     
    Execute code asynchronously.
     
    Parameters:
     Name Type Description Default extra_headers Headers | None 
    Send extra headers
     None extra_query Query | None 
    Add additional query parameters to the request
     None extra_body Body | None 
    Add additional JSON properties to the request
     None timeout float | Timeout | None | NotGiven 
    Override the client-level default timeout for this request, in seconds
     NOT_GIVEN"},{"location":"ref/data-hub/low-level-api.html#deeporigin_data._client.DeeporiginData.execute_code_sync","title":"execute_code_sync","text":"
    execute_code_sync(\n    *,\n    code: str,\n    code_language: Literal[\"python\"],\n    extra_headers: Headers | None = None,\n    extra_query: Query | None = None,\n    extra_body: Body | None = None,\n    timeout: float | Timeout | None | NotGiven = NOT_GIVEN\n) -> ExecuteCodeSyncResponse\n
     
    Execute code synchronously.
     
    Parameters:
     Name Type Description Default extra_headers Headers | None 
    Send extra headers
     None extra_query Query | None 
    Add additional query parameters to the request
     None extra_body Body | None 
    Add additional JSON properties to the request
     None timeout float | Timeout | None | NotGiven 
    Override the client-level default timeout for this request, in seconds
     NOT_GIVEN"},{"location":"ref/data-hub/low-level-api.html#deeporigin_data._client.DeeporiginData.export_database","title":"export_database","text":"
    export_database(\n    *,\n    database_id: str,\n    format: Literal[\"csv\"],\n    column_selection: (\n        ColumnSelection | NotGiven\n    ) = NOT_GIVEN,\n    filter: Filter | NotGiven = NOT_GIVEN,\n    row_sort: Iterable[RowSort] | NotGiven = NOT_GIVEN,\n    extra_headers: Headers | None = None,\n    extra_query: Query | None = None,\n    extra_body: Body | None = None,\n    timeout: float | Timeout | None | NotGiven = NOT_GIVEN\n) -> BinaryAPIResponse\n
     
    Exports a database to a file.
     
    Parameters:
     Name Type Description Default column_selection ColumnSelection | NotGiven 
    Select columns for inclusion/exclusion.
     NOT_GIVEN row_sort Iterable[RowSort] | NotGiven 
    Sort rows by column.
     NOT_GIVEN extra_headers Headers | None 
    Send extra headers
     None extra_query Query | None 
    Add additional query parameters to the request
     None extra_body Body | None 
    Add additional JSON properties to the request
     None timeout float | Timeout | None | NotGiven 
    Override the client-level default timeout for this request, in seconds
     NOT_GIVEN"},{"location":"ref/data-hub/low-level-api.html#deeporigin_data._client.DeeporiginData.get_code_execution_result","title":"get_code_execution_result","text":"
    get_code_execution_result(\n    *,\n    id: str,\n    extra_headers: Headers | None = None,\n    extra_query: Query | None = None,\n    extra_body: Body | None = None,\n    timeout: float | Timeout | None | NotGiven = NOT_GIVEN\n) -> object\n
     
    Returns the result of a code execution.
     
    Parameters:
     Name Type Description Default id str 
    Deep Origin system ID.
     required extra_headers Headers | None 
    Send extra headers
     None extra_query Query | None 
    Add additional query parameters to the request
     None extra_body Body | None 
    Add additional JSON properties to the request
     None timeout float | Timeout | None | NotGiven 
    Override the client-level default timeout for this request, in seconds
     NOT_GIVEN"},{"location":"ref/data-hub/low-level-api.html#deeporigin_data._client.DeeporiginData.import_rows","title":"import_rows","text":"
    import_rows(\n    *,\n    database_id: str,\n    add_columns: Iterable[AddColumn] | NotGiven = NOT_GIVEN,\n    creation_block_id: str | NotGiven = NOT_GIVEN,\n    creation_parent_id: str | NotGiven = NOT_GIVEN,\n    extra_headers: Headers | None = None,\n    extra_query: Query | None = None,\n    extra_body: Body | None = None,\n    timeout: float | Timeout | None | NotGiven = NOT_GIVEN\n) -> ImportRowsResponse\n
     
    Creates new rows from CSV data.
     
    Parameters:
     Name Type Description Default add_columns Iterable[AddColumn] | NotGiven 
    Optionally add additional columns to the database during import.
     NOT_GIVEN extra_headers Headers | None 
    Send extra headers
     None extra_query Query | None 
    Add additional query parameters to the request
     None extra_body Body | None 
    Add additional JSON properties to the request
     None timeout float | Timeout | None | NotGiven 
    Override the client-level default timeout for this request, in seconds
     NOT_GIVEN"},{"location":"ref/data-hub/low-level-api.html#deeporigin_data._client.DeeporiginData.list_database_column_unique_values_v2","title":"list_database_column_unique_values_v2","text":"
    list_database_column_unique_values_v2(\n    *,\n    column_id: str,\n    database_id: str,\n    extra_headers: Headers | None = None,\n    extra_query: Query | None = None,\n    extra_body: Body | None = None,\n    timeout: float | Timeout | None | NotGiven = NOT_GIVEN\n) -> ListDatabaseColumnUniqueValuesV2Response\n
     
    Returns the unique values for every cell within the column.
     
    Parameters:
     Name Type Description Default extra_headers Headers | None 
    Send extra headers
     None extra_query Query | None 
    Add additional query parameters to the request
     None extra_body Body | None 
    Add additional JSON properties to the request
     None timeout float | Timeout | None | NotGiven 
    Override the client-level default timeout for this request, in seconds
     NOT_GIVEN"},{"location":"ref/data-hub/low-level-api.html#deeporigin_data._client.DeeporiginData.list_database_rows","title":"list_database_rows","text":"
    list_database_rows(\n    *,\n    database_row_id: str,\n    column_selection: (\n        ColumnSelection | NotGiven\n    ) = NOT_GIVEN,\n    filter: Filter | NotGiven = NOT_GIVEN,\n    limit: int | NotGiven = NOT_GIVEN,\n    offset: int | NotGiven = NOT_GIVEN,\n    row_sort: Iterable[RowSort] | NotGiven = NOT_GIVEN,\n    extra_headers: Headers | None = None,\n    extra_query: Query | None = None,\n    extra_body: Body | None = None,\n    timeout: float | Timeout | None | NotGiven = NOT_GIVEN\n) -> ListDatabaseRowsResponse\n
     
    List database rows with full row data.
     
    Parameters:
     Name Type Description Default column_selection ColumnSelection | NotGiven 
    Select columns for inclusion/exclusion.
     NOT_GIVEN row_sort Iterable[RowSort] | NotGiven 
    Sort rows by column.
     NOT_GIVEN extra_headers Headers | None 
    Send extra headers
     None extra_query Query | None 
    Add additional query parameters to the request
     None extra_body Body | None 
    Add additional JSON properties to the request
     None timeout float | Timeout | None | NotGiven 
    Override the client-level default timeout for this request, in seconds
     NOT_GIVEN"},{"location":"ref/data-hub/low-level-api.html#deeporigin_data._client.DeeporiginData.list_files","title":"list_files","text":"
    list_files(\n    *,\n    filters: Iterable[Filter] | NotGiven = NOT_GIVEN,\n    extra_headers: Headers | None = None,\n    extra_query: Query | None = None,\n    extra_body: Body | None = None,\n    timeout: float | Timeout | None | NotGiven = NOT_GIVEN\n) -> ListFilesResponse\n
     
    Returns a list of files using the filters.
     
    Parameters:
     Name Type Description Default extra_headers Headers | None 
    Send extra headers
     None extra_query Query | None 
    Add additional query parameters to the request
     None extra_body Body | None 
    Add additional JSON properties to the request
     None timeout float | Timeout | None | NotGiven 
    Override the client-level default timeout for this request, in seconds
     NOT_GIVEN"},{"location":"ref/data-hub/low-level-api.html#deeporigin_data._client.DeeporiginData.list_mentions","title":"list_mentions","text":"
    list_mentions(\n    *,\n    query: str,\n    extra_headers: Headers | None = None,\n    extra_query: Query | None = None,\n    extra_body: Body | None = None,\n    timeout: float | Timeout | None | NotGiven = NOT_GIVEN\n) -> ListMentionsResponse\n
     
    Returns entities that can be mentioned in a notebook.
     
    Parameters:
     Name Type Description Default extra_headers Headers | None 
    Send extra headers
     None extra_query Query | None 
    Add additional query parameters to the request
     None extra_body Body | None 
    Add additional JSON properties to the request
     None timeout float | Timeout | None | NotGiven 
    Override the client-level default timeout for this request, in seconds
     NOT_GIVEN"},{"location":"ref/data-hub/low-level-api.html#deeporigin_data._client.DeeporiginData.list_row_back_references","title":"list_row_back_references","text":"
    list_row_back_references(\n    *,\n    database_id: str,\n    row_id: str,\n    extra_headers: Headers | None = None,\n    extra_query: Query | None = None,\n    extra_body: Body | None = None,\n    timeout: float | Timeout | None | NotGiven = NOT_GIVEN\n) -> ListRowBackReferencesResponse\n
     
    Finds all the places a row is referenced.
     
    Parameters:
     Name Type Description Default extra_headers Headers | None 
    Send extra headers
     None extra_query Query | None 
    Add additional query parameters to the request
     None extra_body Body | None 
    Add additional JSON properties to the request
     None timeout float | Timeout | None | NotGiven 
    Override the client-level default timeout for this request, in seconds
     NOT_GIVEN"},{"location":"ref/data-hub/low-level-api.html#deeporigin_data._client.DeeporiginData.list_rows","title":"list_rows","text":"
    list_rows(\n    *,\n    filters: Iterable[Filter],\n    extra_headers: Headers | None = None,\n    extra_query: Query | None = None,\n    extra_body: Body | None = None,\n    timeout: float | Timeout | None | NotGiven = NOT_GIVEN\n) -> ListRowsResponse\n
     
    Lists rows at a given depth in the hierarchy.
     
    Parameters:
     Name Type Description Default extra_headers Headers | None 
    Send extra headers
     None extra_query Query | None 
    Add additional query parameters to the request
     None extra_body Body | None 
    Add additional JSON properties to the request
     None timeout float | Timeout | None | NotGiven 
    Override the client-level default timeout for this request, in seconds
     NOT_GIVEN"},{"location":"ref/data-hub/low-level-api.html#deeporigin_data._client.DeeporiginData.lock_database","title":"lock_database","text":"
    lock_database(\n    *,\n    database_id: str,\n    extra_headers: Headers | None = None,\n    extra_query: Query | None = None,\n    extra_body: Body | None = None,\n    timeout: float | Timeout | None | NotGiven = NOT_GIVEN\n) -> LockDatabaseResponse\n
     
    A locked database cannot be edited.
     
    Parameters:
     Name Type Description Default extra_headers Headers | None 
    Send extra headers
     None extra_query Query | None 
    Add additional query parameters to the request
     None extra_body Body | None 
    Add additional JSON properties to the request
     None timeout float | Timeout | None | NotGiven 
    Override the client-level default timeout for this request, in seconds
     NOT_GIVEN"},{"location":"ref/data-hub/low-level-api.html#deeporigin_data._client.DeeporiginData.parse_base_sequence_data","title":"parse_base_sequence_data","text":"
    parse_base_sequence_data(\n    *,\n    file_id: str,\n    extra_headers: Headers | None = None,\n    extra_query: Query | None = None,\n    extra_body: Body | None = None,\n    timeout: float | Timeout | None | NotGiven = NOT_GIVEN\n) -> ParseBaseSequenceDataResponse\n
     
    Parses a base sequence file and returns the parsed result.
     
    Parameters:
     Name Type Description Default extra_headers Headers | None 
    Send extra headers
     None extra_query Query | None 
    Add additional query parameters to the request
     None extra_body Body | None 
    Add additional JSON properties to the request
     None timeout float | Timeout | None | NotGiven 
    Override the client-level default timeout for this request, in seconds
     NOT_GIVEN"},{"location":"ref/data-hub/low-level-api.html#deeporigin_data._client.DeeporiginData.resolve_ids","title":"resolve_ids","text":"
    resolve_ids(\n    *,\n    database_ids: List[str] | NotGiven = NOT_GIVEN,\n    rows: Iterable[Row] | NotGiven = NOT_GIVEN,\n    workspace_ids: List[str] | NotGiven = NOT_GIVEN,\n    extra_headers: Headers | None = None,\n    extra_query: Query | None = None,\n    extra_body: Body | None = None,\n    timeout: float | Timeout | None | NotGiven = NOT_GIVEN\n) -> ResolveIDsResponse\n
     
    Resolves between system IDs and human IDs (HIDs).
     
    Parameters:
     Name Type Description Default extra_headers Headers | None 
    Send extra headers
     None extra_query Query | None 
    Add additional query parameters to the request
     None extra_body Body | None 
    Add additional JSON properties to the request
     None timeout float | Timeout | None | NotGiven 
    Override the client-level default timeout for this request, in seconds
     NOT_GIVEN"},{"location":"ref/data-hub/low-level-api.html#deeporigin_data._client.DeeporiginData.unlock_database","title":"unlock_database","text":"
    unlock_database(\n    *,\n    database_id: str,\n    extra_headers: Headers | None = None,\n    extra_query: Query | None = None,\n    extra_body: Body | None = None,\n    timeout: float | Timeout | None | NotGiven = NOT_GIVEN\n) -> UnlockDatabaseResponse\n
     
    An unlocked database can be edited.
     
    Parameters:
     Name Type Description Default extra_headers Headers | None 
    Send extra headers
     None extra_query Query | None 
    Add additional query parameters to the request
     None extra_body Body | None 
    Add additional JSON properties to the request
     None timeout float | Timeout | None | NotGiven 
    Override the client-level default timeout for this request, in seconds
     NOT_GIVEN"},{"location":"ref/data-hub/low-level-api.html#deeporigin_data._client.DeeporiginData.update_database","title":"update_database","text":"
    update_database(\n    *,\n    id: str,\n    database: Database,\n    extra_headers: Headers | None = None,\n    extra_query: Query | None = None,\n    extra_body: Body | None = None,\n    timeout: float | Timeout | None | NotGiven = NOT_GIVEN\n) -> UpdateDatabaseResponse\n
     
    Update a database.
     
    Parameters:
     Name Type Description Default extra_headers Headers | None 
    Send extra headers
     None extra_query Query | None 
    Add additional query parameters to the request
     None extra_body Body | None 
    Add additional JSON properties to the request
     None timeout float | Timeout | None | NotGiven 
    Override the client-level default timeout for this request, in seconds
     NOT_GIVEN"},{"location":"ref/data-hub/low-level-api.html#deeporigin_data._client.DeeporiginData.update_database_column","title":"update_database_column","text":"
    update_database_column(\n    *,\n    column: Column,\n    column_id: str,\n    database_id: str,\n    extra_headers: Headers | None = None,\n    extra_query: Query | None = None,\n    extra_body: Body | None = None,\n    timeout: float | Timeout | None | NotGiven = NOT_GIVEN\n) -> UpdateDatabaseColumnResponse\n
     
    Update a column in a database.
     
    Parameters:
     Name Type Description Default extra_headers Headers | None 
    Send extra headers
     None extra_query Query | None 
    Add additional query parameters to the request
     None extra_body Body | None 
    Add additional JSON properties to the request
     None timeout float | Timeout | None | NotGiven 
    Override the client-level default timeout for this request, in seconds
     NOT_GIVEN"},{"location":"ref/data-hub/low-level-api.html#deeporigin_data._client.DeeporiginData.update_workspace","title":"update_workspace","text":"
    update_workspace(\n    *,\n    id: str,\n    workspace: Workspace,\n    extra_headers: Headers | None = None,\n    extra_query: Query | None = None,\n    extra_body: Body | None = None,\n    timeout: float | Timeout | None | NotGiven = NOT_GIVEN\n) -> UpdateWorkspaceResponse\n
     
    Update a workspace.
     
    Parameters:
     Name Type Description Default extra_headers Headers | None 
    Send extra headers
     None extra_query Query | None 
    Add additional query parameters to the request
     None extra_body Body | None 
    Add additional JSON properties to the request
     None timeout float | Timeout | None | NotGiven 
    Override the client-level default timeout for this request, in seconds
     NOT_GIVEN"},{"location":"ref/data-hub/types.html","title":"Classes and constants","text":"
    This page lists some classes, types and constants used in this library.
    "},{"location":"ref/data-hub/types.html#src.data_hub.dataframe.DataFrame","title":"src.data_hub.dataframe.DataFrame","text":"
                   Bases: DataFrame
     
    A subclass of pandas DataFrame that allows for easy updating of a Deep Origin database. This can be used as a drop-in replacement for a pandas DataFrame, and should support all methods a pandas DataFrame supports.
     
    The primary method of creating an object of this type is to use the from_deeporigin class method.
    "},{"location":"ref/data-hub/types.html#src.data_hub.dataframe.DataFrame.auto_sync","title":"auto_sync  class-attribute instance-attribute","text":"
    auto_sync: bool = False\n
     
    When True, changes made to the dataframe will be automatically synced to the Deep Origin database this dataframe represents.
    "},{"location":"ref/data-hub/types.html#src.data_hub.dataframe.DataFrame.from_deeporigin","title":"from_deeporigin  classmethod","text":"
    from_deeporigin(\n    database_id: str,\n    *,\n    use_file_names: bool = True,\n    reference_format: IDFormat = \"human-id\",\n    filter: Optional[dict] = None,\n    client=None\n)\n
     
    Create a local Deep Origin DataFrame from a Deep Origin database.
     
    Parameters:
     Name Type Description Default database_id str 
    The ID of the Deep Origin database.
     required use_file_names bool 
    Whether to use the file names in the Deep Origin database. Defaults to True.
     True reference_format IDFormat 
    The format of the IDs in the Deep Origin database. Defaults to \"human-id\".
     'human-id'"},{"location":"ref/data-hub/types.html#src.data_hub.dataframe.DataFrame.to_deeporigin","title":"to_deeporigin","text":"
    to_deeporigin()\n
     
    Write data in dataframe to Deep Origin
     
    Deep Origin DataFrames can automatically synchronize
     
    To automatically save changes to local DataFrames to Deep Origin databases, set the auto_sync attribute of the dataframe True.
    "},{"location":"ref/data-hub/types.html#src.utils.constants","title":"src.utils.constants","text":"
    this module contains constants used in the rest of this library
    "},{"location":"ref/data-hub/types.html#src.utils.constants.Cardinality","title":"Cardinality  module-attribute","text":"
    Cardinality = Literal['one', 'many']\n
     
    The cardinality defines whether a cell in a database can contain one or multiple objects
    "},{"location":"ref/data-hub/types.html#src.utils.constants.DataType","title":"DataType  module-attribute","text":"
    DataType = Literal[\n    \"integer\",\n    \"select\",\n    \"date\",\n    \"text\",\n    \"file\",\n    \"reference\",\n    \"editor\",\n    \"float\",\n    \"boolean\",\n]\n
     
    Type of a column in a Deep Origin database. See this page in the documentation for more information.
    "},{"location":"ref/data-hub/types.html#src.utils.constants.DatabaseReturnType","title":"DatabaseReturnType  module-attribute","text":"
    DatabaseReturnType = Literal['dataframe', 'dict']\n
     
    Return type for api.get_dataframe
    "},{"location":"ref/data-hub/types.html#src.utils.constants.FileStatus","title":"FileStatus  module-attribute","text":"
    FileStatus = Literal['ready', 'archived']\n
     
    Status of a file. Ready files are ready to be used, downloaded, and operated on.
    "},{"location":"ref/data-hub/types.html#src.utils.constants.IDFormat","title":"IDFormat  module-attribute","text":"
    IDFormat = Literal['human-id', 'system-id']\n
     
    Format of an ID
    "},{"location":"ref/data-hub/types.html#src.utils.constants.ObjectType","title":"ObjectType  module-attribute","text":"
    ObjectType = Literal['row', 'database', 'workspace']\n
     
    Type of a row. In Deep Origin, a row can be a database row, a database or a workspace
    "},{"location":"ref/data-hub/types.html#src.utils.constants.PREFIXES","title":"PREFIXES  dataclass","text":"
    Prefixes for CLI and Python client
    "},{"location":"tools/index.html","title":"Tools on Deep Origin","text":"
    This page describes how you can run tools on Deep Origin.
    "},{"location":"tools/index.html#what-are-tools","title":"What are tools?","text":"
    Tools are containerized scientific tools that can be run on the Deep Origin platform. The Deep Origin API (and this python client) make it easy to run tools on the Deep Origin platform, and wire up inputs and outputs. 
    "},{"location":"tools/index.html#can-i-make-my-own-tools","title":"Can I make my own tools?","text":"
    This ability is coming soon. 
    "},{"location":"tools/vina.html","title":"AutoDock Vina","text":"
    AutoDock Vina is a molecular docking tool widely used in computational drug discovery. It predicts the binding mode of a small molecule (ligand) to a protein (receptor) by modeling their interactions. Vina is known for its high performance, accuracy, and user-friendly interface. It calculates the binding affinity and provides docking poses of the ligand in the receptor\u2019s active site.
     
    Vina is commonly used to screen potential drug candidates, study protein-ligand interactions, and explore binding mechanisms. It employs a scoring function to evaluate the strength of binding and an efficient optimization algorithm to search for the best docking configuration
    "},{"location":"tools/vina.html#file-inputs","title":"File Inputs","text":""},{"location":"tools/vina.html#1-receptor-file","title":"1. Receptor File","text":"
       
    • Format: PDBQT (Protein Data Bank, with charges and torsions).
      •  
    • This file represents the target (e.g., a protein or DNA structure).
      •  
     
    Upload this file to the Data Hub. Typically, you would upload this file to a database dedicated to runs with this tool, in a column named receptor.
    "},{"location":"tools/vina.html#2-ligand-file","title":"2. Ligand File","text":"
       
    • Format: PDBQT.
      •  
    • Represents the small molecule (e.g., a drug or compound).
      •  
    • Prepared by calculating torsions and assigning charges using AutoDock Tools or MGLTools.
      •  
    • Other input formats (e.g., PDB or MOL2) must be converted to PDBQT using preparation tools before use in AutoDock Vina.
      •  
     
    Upload this file to the Data Hub. Typically, you would upload this file to a database dedicated to runs with this tool, in a column named ligand.
    "},{"location":"tools/vina.html#parameters","title":"Parameters","text":"
    This section describes the parameters for a tool run, that are passed in the start_run function.
    "},{"location":"tools/vina.html#search-space","title":"Search Space","text":"
    Defines the area of the receptor where docking will occur. This is critical for focusing on the active site or binding pocket.
    "},{"location":"tools/vina.html#center_x-center_y-center_z","title":"center_x, center_y, center_z:","text":"
       
    • Coordinates of the center of the search box, specified in \u00c5ngstroms.
      •  
    • Should be based on the binding site of the receptor (obtained from experimental data or visual inspection).
      •  
    "},{"location":"tools/vina.html#size_x-size_y-size_z","title":"size_x, size_y, size_z:","text":"
       
    • Dimensions of the search box along each axis (in \u00c5ngstroms).
      •  
    • Determines the search region\u2019s size. A larger box covers more area but increases computation time.
      •  
    • For most cases, sizes between 20-30 \u00c5ngstroms per side are typical for a flexible ligand.
      •  
    "},{"location":"tools/vina.html#docking-parameters","title":"Docking Parameters","text":""},{"location":"tools/vina.html#energy_range","title":"energy_range","text":"
       
    • The energy difference (in kcal/mol) between the best pose and the worst acceptable pose.
      •  
    • Smaller values prioritize only low-energy poses; larger values allow more diverse poses.
      •  
    "},{"location":"tools/vina.html#exhaustiveness","title":"exhaustiveness:","text":"
       
    • Determines the thoroughness of the search.
      •  
    • Higher values increase the number of sampling attempts, improving accuracy but requiring more computational time.
      •  
    • Default is 8; lower values (e.g., 1-4) are faster but less exhaustive.
      •  
    "},{"location":"tools/vina.html#num_modes","title":"num_modes:","text":"
       
    • The maximum number of docking poses to generate.
      •  
    • Vina will output up to this many unique poses for analysis.
      •  
    "},{"location":"tools/vina.html#running-vina-on-deep-origin","title":"Running Vina on Deep Origin","text":"
    To run AutoDock Vina on Deep Origin, follow these steps:
    "},{"location":"tools/vina.html#1-create-a-database-to-store-input-and-output-files","title":"1. Create a database to store input and output files","text":""},{"location":"tools/vina.html#2-start-a-tool-run-on-deep-origin","title":"2. Start a tool run on Deep Origin","text":"
    For this tool run, we will use the following parameters:
     
    search_space = {\n    \"center_x\": 15.190,\n    \"center_y\": 53.903,\n    \"center_z\": 16.917,\n    \"size_x\": 1.1,\n    \"size_y\": 1.1,\n    \"size_z\": 1.1,\n}\n\ndocking = {\n    \"energy_range\": 0.3,\n    \"exhaustiveness\": 1,\n    \"num_modes\": 9,\n}\n
     
    To start a tool run, use:
     
    from deeporigin.tools import autodock_vina\n\njob_id = autodock_vina.start_run(\n    database_id=\"<your-db-name>\",\n    row_id=\"<row-name>\",\n    search_space=search_space,\n    docking=docking,\n    output_column_name=\"<output-column-name>\",\n    receptor_column_name=\"<receptor-column-name>\",\n    ligand_column_name=\"<ligand-column-name>\",\n)\n
     
    start_run returns the ID of the tool run, that can be used to monitor the status of the run and terminate it if needed. 
     
    start_run prints a message that looks like:
     
    \ud83e\uddec Job started with ID: 9f7a3741-e392-45fb-a349-804b7fca07d7\n
     
    To monitor the status of the tool run, use:
     
    from deeporigin.tools.utils import query_run_status\nquery_run_status(\"9f7a3741-e392-45fb-a349-804b7fca07d7\")\n
     
    To wait for the tool run to finish, use:
     
    from deeporigin.tools.utils import wait_for_job\nwait_for_job(\"9f7a3741-e392-45fb-a349-804b7fca07d7\")\n
    "},{"location":"tools/vina.html#outputs","title":"Outputs","text":""},{"location":"tools/vina.html#docked-poses","title":"Docked Poses","text":"
       
    • Format: PDBQT.
      •  
    • Contains the ligand poses docked in the receptor.
      •  
    • Each pose includes the coordinates, torsional flexibility, and orientation of the ligand.
      •  
    "}]}
\ No newline at end of file
diff --git a/sitemap.xml b/sitemap.xml
index a5a6d0e..76a39e8 100644
--- a/sitemap.xml
+++ b/sitemap.xml
@@ -2,98 +2,114 @@
 
     
          https://client-docs.deeporigin.io/index.html
-         2024-12-05
+         2024-12-17
     
     
          https://client-docs.deeporigin.io/changelog.html
-         2024-12-05
+         2024-12-17
     
     
          https://client-docs.deeporigin.io/configure.html
-         2024-12-05
+         2024-12-17
     
     
          https://client-docs.deeporigin.io/install.html
-         2024-12-05
+         2024-12-17
     
     
          https://client-docs.deeporigin.io/compute-hub/index.html
-         2024-12-05
+         2024-12-17
     
     
          https://client-docs.deeporigin.io/data-hub/index.html
-         2024-12-05
+         2024-12-17
     
     
          https://client-docs.deeporigin.io/data-hub/dataframes.html
-         2024-12-05
+         2024-12-17
     
     
          https://client-docs.deeporigin.io/how-to/auth.html
-         2024-12-05
+         2024-12-17
     
     
          https://client-docs.deeporigin.io/how-to/compute-hub/variables.html
-         2024-12-05
+         2024-12-17
     
     
          https://client-docs.deeporigin.io/how-to/compute-hub/workstation-info.html
-         2024-12-05
+         2024-12-17
     
     
          https://client-docs.deeporigin.io/how-to/data-hub/add-data.html
-         2024-12-05
+         2024-12-17
     
     
          https://client-docs.deeporigin.io/how-to/data-hub/create.html
-         2024-12-05
+         2024-12-17
     
     
          https://client-docs.deeporigin.io/how-to/data-hub/delete.html
-         2024-12-05
+         2024-12-17
     
     
          https://client-docs.deeporigin.io/how-to/data-hub/download-files.html
-         2024-12-05
+         2024-12-17
     
     
          https://client-docs.deeporigin.io/how-to/data-hub/list-data.html
-         2024-12-05
+         2024-12-17
     
     
          https://client-docs.deeporigin.io/how-to/data-hub/upload-files.html
-         2024-12-05
+         2024-12-17
     
     
          https://client-docs.deeporigin.io/how-to/data-hub/view-data.html
-         2024-12-05
+         2024-12-17
     
     
          https://client-docs.deeporigin.io/how-to/data-hub/write-data.html
-         2024-12-05
+         2024-12-17
     
     
          https://client-docs.deeporigin.io/how-to/platform/user-info.html
-         2024-12-05
+         2024-12-17
     
     
          https://client-docs.deeporigin.io/how-to/platform/workstation-info.html
-         2024-12-05
+         2024-12-17
+    
+    
+         https://client-docs.deeporigin.io/how-to/tools/list-tools.html
+         2024-12-17
+    
+    
+         https://client-docs.deeporigin.io/how-to/tools/run-tools.html
+         2024-12-17
     
     
          https://client-docs.deeporigin.io/platform/index.html
-         2024-12-05
+         2024-12-17
     
     
          https://client-docs.deeporigin.io/ref/data-hub/high-level-api.html
-         2024-12-05
+         2024-12-17
     
     
          https://client-docs.deeporigin.io/ref/data-hub/low-level-api.html
-         2024-12-05
+         2024-12-17
     
     
          https://client-docs.deeporigin.io/ref/data-hub/types.html
-         2024-12-05
+         2024-12-17
+    
+    
+         https://client-docs.deeporigin.io/tools/index.html
+         2024-12-17
+    
+    
+         https://client-docs.deeporigin.io/tools/vina.html
+         2024-12-17
     
 
\ No newline at end of file
diff --git a/sitemap.xml.gz b/sitemap.xml.gz
index e88af2f..313a1c3 100644
Binary files a/sitemap.xml.gz and b/sitemap.xml.gz differ
diff --git a/tools/index.html b/tools/index.html
new file mode 100644
index 0000000..f192a73
--- /dev/null
+++ b/tools/index.html
@@ -0,0 +1,1781 @@
+
+
+
+  
+    
+      
+      
+      
+      
+        
+      
+      
+        
+      
+      
+        
+      
+      
+        
+      
+      
+      
+      
+    
+    
+      
+        Tools on Deep Origin - CLI and Python client | Deep Origin
+      
+    
+    
+      
+      
+        
+        
+      
+      
+
+
+    
+    
+      
+    
+    
+      
+        
+        
+        
+        
+        
+      
+    
+    
+      
+    
+      
+    
+    
+    
+      
+
+    
+    
+    
+  
+  
+  
+    
+    
+    
+    
+    
+    
+  
+    
+    
+    
+    
+    
+    
    
+      
+    
    
+    
+    
+      
+
+
    
+  
+  
+
    
+    
+    
    
+      
+      
+        
+          
+            
+
+          
+        
+      
+      
    
+        
    
+          
+            
+              
+              
    
+                
    
+                  
    
+                    
+
+
+  
+
+
+
+                  
    
+                
    
+              
    
+            
+            
+              
+              
    
+                
    
+                  
    
+                    
+
+  
+
+
+                  
    
+                
    
+              
    
+            
+          
+          
+            
    
+              
    
+                
+                  
+
+  
+  
+
+
+
    Tools on Deep Origin
    
+
    This page describes how you can run tools on Deep Origin.
    
+
    What are tools?
    
+
    Tools are containerized scientific tools that can be run on the Deep Origin platform. The Deep Origin API (and this python client) make it easy to run tools on the Deep Origin platform, and wire up inputs and outputs. 
    
+
    Can I make my own tools?
    
+
    This ability is coming soon. 
    
+
+
+
+
+
+
+
+
+
+
+
+
+                
+              
    
+            
    
+          
+          
+  
+
+
+        
    
+        
+          
+        
+      
    
+      
+        
+      
+    
    
+    
    
+      
    
+    
    
+    
+      
    
+    
+    
+    
+    
+    
+      
+      
+    
+  
+
\ No newline at end of file
diff --git a/tools/vina.html b/tools/vina.html
new file mode 100644
index 0000000..90ed68c
--- /dev/null
+++ b/tools/vina.html
@@ -0,0 +1,2263 @@
+
+
+
+  
+    
+      
+      
+      
+      
+        
+      
+      
+        
+      
+      
+        
+      
+      
+        
+      
+      
+      
+      
+    
+    
+      
+        Autodock Vina - CLI and Python client | Deep Origin
+      
+    
+    
+      
+      
+        
+        
+      
+      
+
+
+    
+    
+      
+    
+    
+      
+        
+        
+        
+        
+        
+      
+    
+    
+      
+    
+      
+    
+    
+    
+      
+
+    
+    
+    
+  
+  
+  
+    
+    
+    
+    
+    
+    
+  
+    
+    
+    
+    
+    
+    
    
+      
+    
    
+    
+    
+      
+
+
    
+  
+  
+
    
+    
+    
    
+      
+      
+        
+          
+            
+
+          
+        
+      
+      
    
+        
    
+          
+            
+              
+              
    
+                
    
+                  
    
+                    
+
+
+  
+
+
+
+                  
    
+                
    
+              
    
+            
+            
+              
+              
    
+                
    
+                  
    
+                    
+
+  
+
+
+                  
    
+                
    
+              
    
+            
+          
+          
+            
    
+              
    
+                
+                  
+
+  
+  
+
+
+
    AutoDock Vina
    
+
    AutoDock Vina is a molecular docking tool widely used in computational drug discovery. It predicts the binding mode of a small molecule (ligand) to a protein (receptor) by modeling their interactions. Vina is known for its high performance, accuracy, and user-friendly interface. It calculates the binding affinity and provides docking poses of the ligand in the receptor’s active site.
    
+
    Vina is commonly used to screen potential drug candidates, study protein-ligand interactions, and explore binding mechanisms. It employs a scoring function to evaluate the strength of binding and an efficient optimization algorithm to search for the best docking configuration
    
+
    File Inputs
    
+
    1. Receptor File
    
+
      
+
    • Format: PDBQT (Protein Data Bank, with charges and torsions).
      • 
+
    • This file represents the target (e.g., a protein or DNA structure).
      • 
+
    
+
    Upload this file to the Data Hub. Typically, you would upload this file to a database dedicated to runs with this tool, in a column named receptor.
    
+
    2. Ligand File
    
+
      
+
    • Format: PDBQT.
      • 
+
    • Represents the small molecule (e.g., a drug or compound).
      • 
+
    • Prepared by calculating torsions and assigning charges using AutoDock Tools or MGLTools.
      • 
+
    • Other input formats (e.g., PDB or MOL2) must be converted to PDBQT using preparation tools before use in AutoDock Vina.
      • 
+
    
+
    Upload this file to the Data Hub. Typically, you would upload this file to a database dedicated to runs with this tool, in a column named ligand.
    
+
    Parameters
    
+
    This section describes the parameters for a tool run, that are passed in the start_run function.
    
+
    Search Space
    
+
    Defines the area of the receptor where docking will occur. This is critical for focusing on the active site or binding pocket.
    
+
    center_x, center_y, center_z:
    
+
      
+
    • Coordinates of the center of the search box, specified in Ångstroms.
      • 
+
    • Should be based on the binding site of the receptor (obtained from experimental data or visual inspection).
      • 
+
    
+
    size_x, size_y, size_z:
    
+
      
+
    • Dimensions of the search box along each axis (in Ångstroms).
      • 
+
    • Determines the search region’s size. A larger box covers more area but increases computation time.
      • 
+
    • For most cases, sizes between 20-30 Ångstroms per side are typical for a flexible ligand.
      • 
+
    
+
    Docking Parameters
    
+
    energy_range
    
+
      
+
    • The energy difference (in kcal/mol) between the best pose and the worst acceptable pose.
      • 
+
    • Smaller values prioritize only low-energy poses; larger values allow more diverse poses.
      • 
+
    
+
    exhaustiveness:
    
+
      
+
    • Determines the thoroughness of the search.
      • 
+
    • Higher values increase the number of sampling attempts, improving accuracy but requiring more computational time.
      • 
+
    • Default is 8; lower values (e.g., 1-4) are faster but less exhaustive.
      • 
+
    
+
    num_modes:
    
+
      
+
    • The maximum number of docking poses to generate.
      • 
+
    • Vina will output up to this many unique poses for analysis.
      • 
+
    
+
    Running Vina on Deep Origin
    
+
    To run AutoDock Vina on Deep Origin, follow these steps:
    
+
    1. Create a database to store input and output files
    
+
    2. Start a tool run on Deep Origin
    
+
    For this tool run, we will use the following parameters:
    
+
    search_space = {
+    "center_x": 15.190,
+    "center_y": 53.903,
+    "center_z": 16.917,
+    "size_x": 1.1,
+    "size_y": 1.1,
+    "size_z": 1.1,
+}
+
+docking = {
+    "energy_range": 0.3,
+    "exhaustiveness": 1,
+    "num_modes": 9,
+}
+
    
+
    To start a tool run, use:
    
+
    from deeporigin.tools import autodock_vina
+
+job_id = autodock_vina.start_run(
+    database_id="<your-db-name>",
+    row_id="<row-name>",
+    search_space=search_space,
+    docking=docking,
+    output_column_name="<output-column-name>",
+    receptor_column_name="<receptor-column-name>",
+    ligand_column_name="<ligand-column-name>",
+)
+
    
+
    start_run returns the ID of the tool run, that can be used to monitor the status of the run and terminate it if needed. 
    
+
    start_run prints a message that looks like:
    
+
    🧬 Job started with ID: 9f7a3741-e392-45fb-a349-804b7fca07d7
+
    
+
    To monitor the status of the tool run, use:
    
+
    from deeporigin.tools.utils import query_run_status
+query_run_status("9f7a3741-e392-45fb-a349-804b7fca07d7")
+
    
+
    To wait for the tool run to finish, use:
    
+
    from deeporigin.tools.utils import wait_for_job
+wait_for_job("9f7a3741-e392-45fb-a349-804b7fca07d7")
+
    
+
    Outputs
    
+
    Docked Poses
    
+
      
+
    • Format: PDBQT.
      • 
+
    • Contains the ligand poses docked in the receptor.
      • 
+
    • Each pose includes the coordinates, torsional flexibility, and orientation of the ligand.
      • 
+
    
+
+
+
+
+
+
+
+
+
+
+
+
+                
+              
    
+            
    
+          
+          
+  
+
+
+        
    
+        
+          
+        
+      
    
+      
+        
+      
+    
    
+    
    
+      
    
+    
    
+    
+      
    
+    
+    
+    
+    
+    
+      
+      
+    
+  
+
\ No newline at end of file