ImmyBot Endpoint Management

ImmyBot Endpoint Management

ImmyBot manages Windows endpoints (computers) grouped under tenants (client organizations). This skill covers querying and onboarding those computers and inspecting their state.

API Tools

Tool	Purpose
immybot_computers_list	List computers with tenant/online/OS/status filters
immybot_computers_get	Full detail for one computer by ID
immybot_computers_search	Search by name, serial number, etc.
immybot_computers_inventory	Installed-software / hardware inventory for a computer
immybot_computers_deployments	Deployments targeting a specific computer
immybot_computers_create	Create a new computer record
immybot_computers_trigger_checkin	Force an agent check-in now

Common Workflows

Survey a tenant's fleet

1. immybot_tenants_search → resolve the tenant ID.
2. immybot_computers_list filtered by that tenant ID.
3. Group results by online status and OS to spot stale or offline endpoints.

Locate one computer

immybot_computers_search accepts hostname or serial number. Drill in with immybot_computers_get for OS, last-seen, tenant, and agent state.

Inventory audit

1. immybot_computers_get for the device.
2. immybot_computers_inventory for what is actually installed.
3. immybot_computers_deployments for what desired-state expects.
4. The gap between (2) and (3) is the remediation list — hand it to the software-deployment workflow.

Onboard a new computer

immybot_computers_create registers a record (name, tenant ID, and optional serial / MAC / location). The ImmyBot agent must still be installed on the endpoint for it to come online.

Force a check-in

immybot_computers_trigger_checkin asks the agent to phone home immediately rather than waiting for its next scheduled interval — useful after staging a deployment when you want fast feedback.

Filtering Notes

• online status is a point-in-time snapshot; a computer can be enrolled but offline.
• Always scope immybot_computers_list by tenant when working a specific client — the unscoped list spans the whole MSP fleet.
• Serial number is the most reliable search key when hostnames are not unique across tenants.

Best Practices

• Confirm a computer is online before triggering a maintenance session against it — an offline endpoint just queues work.
• Use inventory data to validate a deployment actually landed rather than trusting the deployment's reported status alone.

Related Skills

• software-deployment — deploy software to these computers
• maintenance-sessions — reconcile desired state
• api-patterns — auth and the desired-state model