API reference: Low-level API¶
Background¶
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
api.list_files()
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.
AsyncDeeporiginData
¶
Bases: AsyncAPIClient
__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: AsyncClient | 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
async
¶
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:
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
|
archive_files
async
¶
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:
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
|
close
async
¶
close() -> None
Close the underlying HTTPX client.
The client will not be usable after this.
configure_column_select_options
async
¶
configure_column_select_options(
*,
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
) -> ConfigureColumnSelectOptionsResponse
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
|
convert_id_format
async
¶
convert_id_format(
*,
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
) -> ConvertIDFormatResponse
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
|
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: AsyncClient | 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
async
¶
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
) -> CreateDatabaseResponse
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
|
create_file_download_url
async
¶
create_file_download_url(
*,
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
) -> CreateFileDownloadURLResponse
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
|
create_file_upload
async
¶
create_file_upload(
*,
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
) -> CreateFileUploadResponse
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
|
create_workspace
async
¶
create_workspace(
*,
workspace: Workspace,
extra_headers: Headers | None = None,
extra_query: Query | None = None,
extra_body: Body | None = None,
timeout: float | Timeout | None | NotGiven = NOT_GIVEN
) -> CreateWorkspaceResponse
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
|
delete_database
async
¶
delete_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
) -> DeleteDatabaseResponse
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
|
delete_database_column
async
¶
delete_database_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
) -> DeleteDatabaseColumnResponse
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
|
delete_rows
async
¶
delete_rows(
*,
database_id: str,
row_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
) -> DeleteRowsResponse
Delete rows 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
|
delete_workspace
async
¶
delete_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
) -> DeleteWorkspaceResponse
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
|
describe_code_execution
async
¶
describe_code_execution(
*,
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
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
|
describe_database_stats
async
¶
describe_database_stats(
*,
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
) -> DescribeDatabaseStatsResponse
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
|
describe_file
async
¶
describe_file(
*,
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
) -> DescribeFileResponse
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
|
describe_row
async
¶
describe_row(
*,
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
) -> DescribeRowResponse
Describe a row
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
|
ensure_rows
async
¶
ensure_rows(
*,
database_id: str,
rows: Iterable[Row],
extra_headers: Headers | None = None,
extra_query: Query | None = None,
extra_body: Body | None = None,
timeout: float | Timeout | None | NotGiven = NOT_GIVEN
) -> EnsureRowsResponse
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
|
execute_code_async
async
¶
execute_code_async(
*,
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
) -> ExecuteCodeAsyncResponse
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
|
execute_code_sync
async
¶
execute_code_sync(
*,
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
) -> ExecuteCodeSyncResponse
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
|
get_code_execution_result
async
¶
get_code_execution_result(
*,
id: str,
extra_headers: Headers | None = None,
extra_query: Query | None = None,
extra_body: Body | None = None,
timeout: float | Timeout | None | NotGiven = NOT_GIVEN
) -> object
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
|
import_rows
async
¶
import_rows(
*,
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
) -> ImportRowsResponse
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
|
list_database_rows
async
¶
list_database_rows(
*,
database_row_id: str,
column_selection: (
ColumnSelection | NotGiven
) = NOT_GIVEN,
creation_block_id: str | NotGiven = NOT_GIVEN,
creation_parent_id: str | NotGiven = NOT_GIVEN,
filter: 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
) -> ListDatabaseRowsResponse
List database rows with full row data.
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
|
list_files
async
¶
list_files(
*,
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
) -> ListFilesResponse
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
|
list_mentions
async
¶
list_mentions(
*,
query: str,
extra_headers: Headers | None = None,
extra_query: Query | None = None,
extra_body: Body | None = None,
timeout: float | Timeout | None | NotGiven = NOT_GIVEN
) -> ListMentionsResponse
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
|
list_row_back_references
async
¶
list_row_back_references(
*,
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
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
|
list_rows
async
¶
list_rows(
*,
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
) -> ListRowsResponse
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
|
update_database
async
¶
update_database(
*,
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
) -> UpdateDatabaseResponse
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
|
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:
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
|
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:
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
|
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:
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
|
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:
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
|
close
¶
close() -> None
Close the underlying HTTPX client.
The client will not be usable after this.
configure_column_select_options
¶
configure_column_select_options(
*,
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
) -> ConfigureColumnSelectOptionsResponse
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
|
convert_id_format
¶
convert_id_format(
*,
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
) -> ConvertIDFormatResponse
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
|
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
¶
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
) -> CreateDatabaseResponse
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
|
create_file_download_url
¶
create_file_download_url(
*,
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
) -> CreateFileDownloadURLResponse
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
|
create_file_upload
¶
create_file_upload(
*,
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
) -> CreateFileUploadResponse
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
|
create_workspace
¶
create_workspace(
*,
workspace: Workspace,
extra_headers: Headers | None = None,
extra_query: Query | None = None,
extra_body: Body | None = None,
timeout: float | Timeout | None | NotGiven = NOT_GIVEN
) -> CreateWorkspaceResponse
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
|
delete_database
¶
delete_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
) -> DeleteDatabaseResponse
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
|
delete_database_column
¶
delete_database_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
) -> DeleteDatabaseColumnResponse
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
|
delete_rows
¶
delete_rows(
*,
database_id: str,
row_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
) -> DeleteRowsResponse
Delete rows 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
|
delete_workspace
¶
delete_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
) -> DeleteWorkspaceResponse
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
|
describe_code_execution
¶
describe_code_execution(
*,
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
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
|
describe_database_stats
¶
describe_database_stats(
*,
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
) -> DescribeDatabaseStatsResponse
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
|
describe_file
¶
describe_file(
*,
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
) -> DescribeFileResponse
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
|
describe_row
¶
describe_row(
*,
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
) -> DescribeRowResponse
Describe a row
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
|
ensure_rows
¶
ensure_rows(
*,
database_id: str,
rows: Iterable[Row],
extra_headers: Headers | None = None,
extra_query: Query | None = None,
extra_body: Body | None = None,
timeout: float | Timeout | None | NotGiven = NOT_GIVEN
) -> EnsureRowsResponse
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
|
execute_code_async
¶
execute_code_async(
*,
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
) -> ExecuteCodeAsyncResponse
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
|
execute_code_sync
¶
execute_code_sync(
*,
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
) -> ExecuteCodeSyncResponse
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
|
get_code_execution_result
¶
get_code_execution_result(
*,
id: str,
extra_headers: Headers | None = None,
extra_query: Query | None = None,
extra_body: Body | None = None,
timeout: float | Timeout | None | NotGiven = NOT_GIVEN
) -> object
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
|
import_rows
¶
import_rows(
*,
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
) -> ImportRowsResponse
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
|
list_database_rows
¶
list_database_rows(
*,
database_row_id: str,
column_selection: (
ColumnSelection | NotGiven
) = NOT_GIVEN,
creation_block_id: str | NotGiven = NOT_GIVEN,
creation_parent_id: str | NotGiven = NOT_GIVEN,
filter: 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
) -> ListDatabaseRowsResponse
List database rows with full row data.
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
|
list_files
¶
list_files(
*,
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
) -> ListFilesResponse
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
|
list_mentions
¶
list_mentions(
*,
query: str,
extra_headers: Headers | None = None,
extra_query: Query | None = None,
extra_body: Body | None = None,
timeout: float | Timeout | None | NotGiven = NOT_GIVEN
) -> ListMentionsResponse
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
|
list_row_back_references
¶
list_row_back_references(
*,
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
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
|
list_rows
¶
list_rows(
*,
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
) -> ListRowsResponse
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
|
update_database
¶
update_database(
*,
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
) -> UpdateDatabaseResponse
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
|
update_database_column
¶
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:
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
|
update_workspace
¶
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:
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
|