aip_sdk.list_datasets

aip_sdk.list_datasets(include_deprecated: bool = False, workspace_id: str | None = None, page: int = 1, per_page: int = 20, client: APIClient | None = None, *, all_workspaces: bool = False) -> list[Dataset]

List datasets, returning typed Dataset objects.

Reads your session's workspace unless you name one, and raises if none is set. Pass all_workspaces=True to read across every workspace you can access.

Parameters

• include_deprecated bool: Include deprecated datasets.
• workspace_id str | None: Return only datasets in this workspace.
• page int: Page number (1-based).
• per_page int: Items per page (max 100).
• client APIClient | None: Optional API client.
• all_workspaces bool: Read across every workspace you can access.

Returns

• list[Dataset]: List of Dataset objects.

Raises

• InvalidArgumentError: If both workspace_id and all_workspaces are given.
• ForbiddenError: If workspace_id names a workspace you cannot access.
• NoWorkspaceSelectedError: No workspace was passed, none is configured for the session, and all_workspaces was not set.