Get Binner instance health, version, user identity, and inventory summary.

Args: check_cloud: Probe Binner Swarm cloud reachability.

Search and filter parts. Returns (id, part_number) unless extra fields are requested.

Args: query: Search keyword across part numbers and descriptions. part_type: Filter by category name or path. bin_number: Filter by storage bin. location: Filter by room or cabinet. package_type: Filter by footprint/package (e.g. '0805', 'SOIC-8'). manufacturer: Filter by manufacturer name. low_stock_only: Return only parts at or below threshold. fields: Extra fields to return (e.g. ['quantity', 'location', 'bin_number']). page: Page number (1-based). limit: Max results per page (1-500). sort_by: Column to sort by (default 'DateCreatedUtc'). direction: 'Ascending' or 'Descending'.

Get component details, bin locations, category paths, and datasheets by part number or ID.

Args: part_numbers: Part numbers to fetch. part_ids: Numeric part IDs to fetch. fields: Optional list of specific fields to return (e.g. ['quantity', 'bin_number', 'location']).

Batch create or update parts. Each item requires 'part_number'.

Args: parts: Part records with fields (e.g. 'part_number', 'quantity', 'cost', 'bin_number', 'part_type'). 'part_type' accepts a numeric ID (e.g. 10 or '10') or a category path/name string.

Batch delete parts by part number or ID.

Args: part_numbers: Part numbers to delete. part_ids: Numeric part IDs to delete.

Search and list maker projects with pagination, keyword search, and metadata.

Args: page: Page number (1-based). limit: Max projects to return (1-500). sort_by: Column to sort by (default 'DateCreatedUtc'). direction: 'Ascending' or 'Descending'. query: Optional search keyword to filter projects by name or description.

Batch inspect maker projects by IDs or names, with optional BOM inclusion.

Args: project_ids: Numeric project IDs to inspect. names: Project names to inspect. include_bom: Include Bill of Materials for each project.

Batch create or update maker projects. Each item requires 'name' (for create) or 'project_id' (for update).

Args: projects: Project records with 'name', optional 'description', optional 'project_id', optional 'archived'.

Batch delete maker projects by ID or name.

Args: project_ids: Numeric project IDs to delete. names: Project names to delete.

Deduct inventory stock for assembling board units of a maker project's BOM.

Args: project_id: Numeric project ID to consume for. name: Project name to consume for. build_quantity: Number of complete board units to assemble (>= 1).

List part types structured as a lightweight hierarchical tree focusing on IDs and names.

Args: depth: Optional maximum depth of tree recursion (e.g. 1 for top-level root categories only). root_id: Optional root category ID to scope the tree to a single subtree. root_name: Optional root category name to scope the tree to a single subtree. include_descriptions: If True, includes description per node (default False). include_part_counts: If True, includes parts count per part type (default False).

Batch create or update part types.

Args: part_types: Part type records with 'name', optional 'description', optional 'parent_part_type_id', optional 'part_type_id'.

Batch delete part types by ID or name.

Args: part_type_ids: Numeric part type IDs to delete. names: Part type names to delete.

Batch allocate, update, or remove BOM line items for a project.

Args: project_id: Target project ID. parts: BOM items with 'part_number'/'part_id', 'quantity', 'reference_designator', optional 'remove'.

Lookup manufacturer pinouts, package footprints, and datasheets from Binner Swarm cloud.

Args: part_numbers: Part numbers / MPNs to look up.