[ImmyBot] Add one or more tags to a set of computers (bulk). Body typically carries the computer ids and the tag ids to apply. Tag ids come from immy_list_tags; computer ids from immy_list_computers.

[ImmyBot] Permanently delete multiple computers (bulk). DESTRUCTIVE — removes the computer records; recover with immy_computers_restore only where ImmyBot supports soft-delete. Body carries the list of computer ids to delete (from immy_list_computers).

[ImmyBot] Move one or more computers to a different tenant. Body carries the computer ids and the destination tenant id (from immy_list_tenants). This reassigns which customer the endpoints belong to.

[ImmyBot] Exclude a computer from maintenance (it will be skipped by maintenance sessions). computerId comes from immy_list_computers. Body carries the exclusion options (e.g. reason/duration) as ImmyBot's schema allows; pass for defaults.

[ImmyBot] Set/update the notes on a computer. computerId comes from immy_list_computers. Body carries the notes payload (e.g. {"notes":"..."}).

[ImmyBot] Trigger a reinventory of a computer (re-collect its software/inventory data). computerId comes from immy_list_computers. This action takes no options — pass for the body.

[ImmyBot] Restore previously (soft-)deleted computers. Body is a JSON array of the computer ids to restore. Counterpart of immy_bulk_delete_computers.

[ImmyBot] Flag a computer as needing onboarding (re-enters the onboarding pipeline). computerId comes from immy_list_computers. This action takes no options — pass for the body. Inverse of immy_computers_skip_onboarding.

[ImmyBot] Mark computers to skip onboarding. Body is a JSON array of skip-onboarding requests (each identifying a computer and its skip options). See immy_list_computers_onboarding for the onboarding queue and immy_computers_set_to_needs_onboarding for the inverse.

[ImmyBot] Update the additional (secondary) persons associated with a computer. computerId comes from immy_list_computers; person ids from immy_list_persons. Body carries the additional-person assignments. See also immy_computers_update_primary_person.

[ImmyBot] Update the primary person associated with a computer (its main user). computerId comes from immy_list_computers; person id from immy_list_persons. Body carries the primary-person assignment. See also immy_computers_update_additional_persons.

[ImmyBot] Get a single computer by id, including its default detail (sessions, primary/additional persons and provider-agent data as ImmyBot resolves them). computerId comes from immy_list_computers / immy_list_computers_paged.

[ImmyBot] List managed computers (basic view). Only pageSize is supported here (capped at 100). For server-side filtering, sorting or paging use immy_list_computers_paged or immy_list_computers_dx; for per-computer detail use immy_get_computers.

[ImmyBot] List computers with their agent connectivity/health status (DevExtreme grid feed). filters/sorts use DevExtreme syntax: filters is a JSON filter array (e.g. ["name","contains","srv"]) and sorts a JSON sort array (e.g. [{"selector":"name","desc":false}]). pageSize is capped at 100. See also immy_list_computers_status for a single computer.

[ImmyBot] Get the device-update form data for a computer (the fields/options used to drive a device update). computerId comes from immy_list_computers.

[ImmyBot] List computers via the raw DevExtreme grid feed. Accepts native DevExtreme load options: skip, take (capped at 100), filter (JSON filter array string) and sort (JSON sort array string). Set requireTotalCount=true to include the total row count in the response.

[ImmyBot] List the event history for a computer. The endpoint pages via skip/take only (no server-side filter/sort); page/pageSize are mapped onto them and pageSize is capped at 100. computerId comes from immy_list_computers.

[ImmyBot] Export the computers grid to an XLSX spreadsheet. The binary is uploaded to StackJack blob storage and returned as a short-lived (~15 minute) read-only SAS URL envelope {sasUrl, contentType, suggestedFilename, sizeBytes, expiresAt} — fetch the file from sasUrl within the window; do NOT decode the URL as content. filters/sorts use DevExtreme syntax.

[ImmyBot] List the computers scoped to the calling identity/session. Takes no parameters. For the full tenant inventory use immy_list_computers or immy_list_computers_paged.

[ImmyBot] List computers currently in the onboarding pipeline (awaiting or undergoing onboarding). Takes no parameters. Related actions: immy_computers_skip_onboarding, immy_computers_set_to_needs_onboarding.

[ImmyBot] List computers with DevExtreme server-side paging, filtering and sorting — the richer counterpart to immy_list_computers. filter/sort use DevExtreme syntax (JSON array strings). pageSize is capped at 100. Some vendor convenience boolean flags (staleOnly, onboardingOnly, orphanedOnly and similar) are not exposed by this tool; express the equivalent constraint through the DevExtreme filter instead.

[ImmyBot] Get the parent-tenant information for a computer (the tenant hierarchy context the computer belongs to). computerId comes from immy_list_computers.

[ImmyBot] Get the current status of a single computer (online/agent/maintenance state). computerId comes from immy_list_computers. For a fleet-wide view use immy_list_computers_agent_status.

[ImmyBot] Remove one or more tags from a set of computers (bulk). Body carries the computer ids and the tag ids to remove. Counterpart of immy_add_tags_to_computers.

[ImmyBot] Resolve the onboarding target-assignments (deployments) that can be overridden for a computer — a preview used before onboarding. computerId comes from immy_list_computers. Read-only.

[ImmyBot] Update a computer (PUT). computerId comes from immy_list_computers. Body is the computer object with the fields to change (e.g. name, notes, tenant assignment as ImmyBot's schema allows).

[ImmyBot] Exclude a single computer from user-affinity tracking. computerId comes from immy_list_computers. Pass for the body unless ImmyBot expects exclusion options. For a bulk operation use immy_computers_set_excluded_from_user_affinity.

[ImmyBot] Bulk set whether a set of computers are excluded from user-affinity tracking. Body carries the computer ids and the excluded flag. For a single computer use immy_computers_exclude_from_user_affinity.

[ImmyBot] Get the results of a specific inventory script for a computer, keyed by inventoryKey. computerId comes from immy_list_computers; inventoryKey identifies which inventory-task/script's output to return.

[ImmyBot] List the detected (installed) software for a single computer. computerId comes from immy_list_computers. Returns the full detected-software set (no server-side paging).

[ImmyBot] List the collected computer inventory (DevExtreme grid feed). filters/sorts use DevExtreme syntax (JSON array strings); pageSize is capped at 100. For a single computer's detected software use immy_list_computers_detected_computer_software.

[ImmyBot] Export the computer-inventory grid to an XLSX spreadsheet. Returns a short-lived (~15 minute) read-only SAS URL envelope {sasUrl, contentType, suggestedFilename, sizeBytes, expiresAt} — fetch the file from sasUrl within the window; do NOT decode the URL as content. filters/sorts use DevExtreme syntax.

[ImmyBot] Search the software inventory across computers by (partial) product name. Returns matching installed-software records. Use immy_list_computers_inventory_software_search_by_upgrade_code to search by MSI upgrade code instead.

[ImmyBot] Search the software inventory across computers by MSI upgrade code. Returns matching installed-software records. Use immy_list_computers_inventory_software_search_by_name to search by product name instead.

[ImmyBot] List computer↔user affinities (which persons are associated with which computers, inferred from usage). DevExtreme grid feed — filters/sorts use DevExtreme syntax (JSON array strings); pageSize is capped at 100.

[ImmyBot] Export the computer user-affinity grid to an XLSX spreadsheet. Returns a short-lived (~15 minute) read-only SAS URL envelope {sasUrl, contentType, suggestedFilename, sizeBytes, expiresAt} — fetch the file from sasUrl within the window; do NOT decode the URL as content. filters/sorts use DevExtreme syntax.

[ImmyBot] Reset the ephemeral-agent circuit breaker for a computer (clears the tripped state so agent launches are retried). computerId comes from immy_list_computers. This action takes no options — pass for the body. Inspect state first with immy_list_computers_ephemeral_agent_circuit_breaker.

[ImmyBot] Enumerate the registry sub-keys under a supplied path on a computer (read-only; POST is used to carry the query path). computerId comes from immy_list_computers. Body identifies the hive/path to enumerate (e.g. {"path":"HKLM:\SOFTWARE"}). Use immy_computers_registry_values to read the values within a key.

[ImmyBot] Read the registry values under a supplied key on a computer (read-only; POST is used to carry the query key). computerId comes from immy_list_computers. Body identifies the hive/key to read (e.g. {"path":"HKLM:\SOFTWARE\..."}). Use immy_computers_registry_keys to list sub-keys first.

[ImmyBot] End (terminate) the live ephemeral-agent session on a computer. DESTRUCTIVE — the active agent session is torn down immediately; any in-flight work on that session is interrupted. computerId comes from immy_list_computers. Launch a new session with immy_launch_ephemeral_agent.

[ImmyBot] Launch a short-lived ephemeral agent on a computer (an ACTION despite the GET verb — it establishes a live agent session, so it is NOT read-only). computerId comes from immy_list_computers. Check state with immy_list_computers_ephemeral_agent and tear down with immy_end_ephemeral_agent_session.

[ImmyBot] Get the current ephemeral-agent state for a computer (whether a short-lived agent session is active and its details). computerId comes from immy_list_computers. Launch one with immy_launch_ephemeral_agent; end one with immy_end_ephemeral_agent_session.

[ImmyBot] Get the ephemeral-agent circuit-breaker state for a computer (whether repeated agent-launch failures have tripped the breaker). computerId comes from immy_list_computers. Reset it with immy_computers_ephemeral_agent_circuit_breaker_reset.

[ImmyBot] Get the provider-link screen-share (remote-control) URL for a computer through a specific provider integration. computerId comes from immy_list_computers; providerLinkId identifies which linked RMM/tool provides the session.

[ImmyBot] Delete a global software item by softwareIdentifier, including all its versions. Deployments (target-assignments) referencing it will break. Cannot be undone. Returns the raw ImmyBot result.

[ImmyBot] Delete a local software item by softwareIdentifier, including all its versions. Deployments (target-assignments) referencing it will break. Cannot be undone. Returns the raw ImmyBot result.

[ImmyBot] Get a single global software item by softwareIdentifier (from immy_list_software_global). Returns the raw ImmyBot software JSON. Use immy_list_software_global_versions for its version list.

[ImmyBot] Get a single local software item by softwareIdentifier (from immy_list_software_local). Returns the raw ImmyBot software JSON. Use immy_list_software_local_versions for its version list.

[ImmyBot] List global (shared/vendor-maintained) software items, optionally filtered with a Sieve `filters` expression. Global software is available to every tenant. Returns raw ImmyBot JSON. Use immy_get_software_global for one item, immy_list_software_global_versions for its versions, or immy_list_software_local for instance-authored software.

[ImmyBot] Get the latest version of a global software item by softwareIdentifier (from immy_list_software_global). Returns the raw ImmyBot version JSON for the newest version. Use immy_list_software_global_versions for the full history.

[ImmyBot] List local (instance-authored) software items, optionally filtered with a Sieve `filters` expression. Local software is defined inside this ImmyBot instance and can be migrated to global. Returns raw ImmyBot JSON. Use immy_get_software_local for one item, or immy_list_software_global for shared software.

[ImmyBot] Get the authorization (tenant/scope access) configuration for a local software item by softwareIdentifier. Shows which tenants may use it. Returns raw ImmyBot JSON. Use immy_software_local_authorization to change it.

[ImmyBot] Get the latest version of a local software item by softwareIdentifier (from immy_list_software_local). Returns the raw ImmyBot version JSON for the newest version. Use immy_list_software_local_versions for the full history.

[ImmyBot] Preview (what-if) migrating a local software item to the global catalog by softwareIdentifier — reports what would change WITHOUT migrating. Run this before immy_software_local_migrate_local_to_global. Returns the raw ImmyBot preview JSON.

[ImmyBot] Partially update a global software item by softwareIdentifier. Provide a JSON object body (fieldsJson) with only the fields to change (JSON merge-patch semantics). Returns the updated software JSON.

[ImmyBot] Partially update a local software item by softwareIdentifier. Provide a JSON object body (fieldsJson) with only the fields to change (JSON merge-patch semantics). Returns the updated software JSON.

[ImmyBot] Create a global software item. Provide a JSON object body (fieldsJson) with the software definition (name, install/detection method, etc.). For a quick minimal create use immy_software_global_fast_create; to upload the installer binary use immy_software_global_upload; add versions with immy_create_global_software_version. Returns the created software JSON.

[ImmyBot] Analyze a global software definition WITHOUT saving it — a read-only preview that returns detection/install evaluation for the supplied definition. Provide a JSON object body (fieldsJson) describing the software/version to analyze. POST is used only to carry the body; nothing is created. Returns the raw analysis JSON.

[ImmyBot] Fast-create a global software item from a minimal definition (ImmyBot infers install/detection defaults). Provide a JSON object body (fieldsJson) — typically just name and package/source hints. Use immy_software_global for full control. Returns the created software JSON.

[ImmyBot] Upload an installer binary for global software (multipart/form-data). Provide the file bytes base64-encoded (base64Content) and a fileName; the file is posted as the `file` form part. Returns the raw ImmyBot upload result JSON (reference the uploaded payload when creating a version with immy_create_global_software_version).

[ImmyBot] Create a local (instance-authored) software item. Provide a JSON object body (fieldsJson) with the software definition. For a quick minimal create use immy_software_local_fast_create; to upload the installer use immy_software_local_upload; add versions with immy_create_local_software_version. Returns the created software JSON.

[ImmyBot] Analyze a local software definition WITHOUT saving it — a read-only preview returning detection/install evaluation for the supplied definition. Provide a JSON object body (fieldsJson). POST is used only to carry the body; nothing is created. Returns the raw analysis JSON.

[ImmyBot] Set the authorization (tenant/scope access) for a local software item by softwareIdentifier. Provide a JSON object body (fieldsJson) describing which tenants/scopes may use it. Read the current config first with immy_list_software_local_authorization. Returns the raw ImmyBot result.

[ImmyBot] Fast-create a local software item from a minimal definition (ImmyBot infers install/detection defaults). Provide a JSON object body (fieldsJson) — typically just name and package/source hints. Use immy_software_local for full control. Returns the created software JSON.

[ImmyBot] Migrate a local software item to the global catalog by softwareIdentifier, making it shared across the instance. Preview the effect first with immy_list_software_local_migrate_local_to_global_what_if. The optional fieldsJson carries migration options (usually none — leave as ). Returns the raw ImmyBot result.

[ImmyBot] Upload an installer binary for local software (multipart/form-data). Provide the file bytes base64-encoded (base64Content) and a fileName; the file is posted as the `file` form part. Returns the raw ImmyBot upload result JSON (reference the uploaded payload when creating a version with immy_create_local_software_version).

[ImmyBot] Add a new version to a global software item (softwareIdentifier from immy_list_software_global). Provide a JSON object body (fieldsJson) with the semanticVersion, install/detection metadata, and payload reference. To upload the binary, use immy_software_global_upload. Returns the created version JSON.

[ImmyBot] Add a new version to a local software item (softwareIdentifier from immy_list_software_local). Provide a JSON object body (fieldsJson) with the semanticVersion, install/detection metadata, and payload reference. To upload the binary, use immy_software_local_upload. Returns the created version JSON.

[ImmyBot] Delete a version from a global software item (softwareIdentifier + semanticVersion). Deployments pinned to this version will no longer resolve. Cannot be undone. Returns the raw ImmyBot result.

[ImmyBot] Delete a version from a local software item (softwareIdentifier + semanticVersion). Deployments pinned to this version will no longer resolve. Cannot be undone. Returns the raw ImmyBot result.

[ImmyBot] Get a single global software version by softwareIdentifier + semanticVersion (both from immy_list_software_global_versions). Returns the raw ImmyBot version JSON, including install metadata.

[ImmyBot] Get a single local software version by softwareIdentifier + semanticVersion (both from immy_list_software_local_versions). Returns the raw ImmyBot version JSON, including install metadata.

[ImmyBot] List the versions of a global (shared/vendor) software item by its softwareIdentifier (from immy_list_software_global / immy_get_software_global). Returns raw ImmyBot JSON. Use immy_get_software_global_versions for one version, or immy_list_software_global_latest for the newest.

[ImmyBot] Request a download URL for a global software version's install payload by softwareIdentifier + semanticVersion. Returns a JSON body containing the URL string — a normal passthrough read, not a binary export. Fetch the URL out-of-band to retrieve the payload.

[ImmyBot] List the versions of a local (per-instance) software item by its softwareIdentifier (from immy_list_software_local / immy_get_software_local). Returns raw ImmyBot JSON. Use immy_get_software_local_versions for one version, or immy_list_software_local_latest for the newest.

[ImmyBot] Request a download URL for a local software version's install payload by softwareIdentifier + semanticVersion. Returns a JSON body containing the URL string — a normal passthrough read, not a binary export. Fetch the URL out-of-band to retrieve the payload.

[ImmyBot] Partially update a global software version (softwareIdentifier + semanticVersion). Provide a JSON object body (fieldsJson) with only the fields to change (JSON merge-patch semantics). Returns the updated version JSON.

[ImmyBot] Partially update a local software version (softwareIdentifier + semanticVersion). Provide a JSON object body (fieldsJson) with only the fields to change (JSON merge-patch semantics). Returns the updated version JSON.

[ImmyBot] Delete a software license by id (from immy_list_licenses). This permanently removes the license and its stored key/file; deployments that reference it will no longer activate. Cannot be undone. Returns the raw ImmyBot result.

[ImmyBot] Get a single software license by id (from immy_list_licenses). Returns the raw ImmyBot license JSON. Use immy_list_licenses_request_download for a download URL to the license file, if any.

[ImmyBot] Create a software license. Provide a JSON object body (fieldsJson) — typically name, softwareId (from immy_list_software_global/immy_list_software_local), the license key/value, and any tenant/scope fields. To attach a license FILE, create the license then use immy_licenses_upload. Returns the created license JSON.

[ImmyBot] Upload a license file (multipart/form-data). Provide the file bytes base64-encoded (base64Content) and a fileName. The file is decoded and posted as the `file` form part. Returns the raw ImmyBot upload result JSON. Pair with immy_licenses to bind the uploaded file to a license record.

[ImmyBot] Look up Chocolatey community-feed packages by exact package id (e.g. "googlechrome", "7zip"). Use this when authoring a Chocolatey-backed global/local software item to confirm the package id and available versions. Returns the raw Chocolatey search JSON. See immy_list_chocolatey_search for a fuzzy term search.

[ImmyBot] Fuzzy-search the Chocolatey community feed by term (matches package id/title). Use this to discover the correct package id before authoring a Chocolatey-backed software item; then confirm with immy_list_chocolatey_find_packages_by_id. Returns the raw Chocolatey search JSON.

[ImmyBot] List software licenses, optionally filtered with a Sieve `filters` expression (e.g. "name@=Adobe"). Each license binds an activation key/file to software applied during deployment. Returns raw ImmyBot JSON. Use immy_list_licenses_dx for the grid/DevExtreme feed, or immy_get_licenses for a single license.

[ImmyBot] DevExtreme grid feed for the licenses table (skip/take paging plus DevExtreme filter/sort). This backs the ImmyBot UI grid; prefer immy_list_licenses for straightforward listing. Returns the raw DevExtreme envelope {data, totalCount}.

[ImmyBot] Request a download URL for a license's uploaded file by license id (from immy_list_licenses). Returns a JSON body containing the URL string — this is a normal passthrough read, not a binary export. Fetch the URL out-of-band to retrieve the file.

[ImmyBot] Update (full replace) a software license by id (from immy_list_licenses). Provide the complete JSON object body (fieldsJson) — omitted fields are cleared, so fetch with immy_get_licenses first and send the merged object. Returns the updated license JSON.

[ImmyBot] List the metascript catalog with full descriptions — the reusable ImmyBot metascript building blocks available to compose scripts and maintenance tasks. Sieve-paged (Page/pageSize/Filters/Sorts); pageSize is clamped to 100. Use immy_list_metascript_catalog_search for a lighter keyword search.

[ImmyBot] Search the metascript catalog by keyword. Sieve-paged (Page/pageSize/Filters/Sorts); pageSize is clamped to 100. Use immy_list_metascript_catalog_describe for full catalog entry descriptions.

[ImmyBot] List the PowerShell/metascript functions exposed to scripts (the built-in function library scripts can call). Sieve-paged (Page/pageSize/Filters/Sorts); pageSize is clamped to 100. Validate a function's PowerShell syntax with immy_scripts_functions_syntax.

[ImmyBot] Get the language/analysis state for an active script language-service terminal. terminalId comes from immy_scripts_language_service_start. Read-only editor support surface.

[ImmyBot] Analyze the syntax of a script function (read-only static analysis — a POST that inspects, not a write). Body carries the function source to check; returns parse/syntax diagnostics. No script is created or run.

[ImmyBot] Start a script language-service session (editor/analysis backend), returning a terminalId used by immy_list_scripts_language_service_language. Body carries the session/init options. This allocates a server-side session — a write.

[ImmyBot] Cancel an in-progress debug script run identified by cancellationId. This aborts a running execution — flagged Destructive because it terminates work in flight. Body carries any additional cancel options.

[ImmyBot] List the preflight scripts currently disabled (preflight scripts run before maintenance to decide applicability). Sieve-paged (Page/pageSize/Filters/Sorts); pageSize is clamped to 100. Toggle enablement with immy_scripts_set_preflight_script_enablement.

[ImmyBot] Resolve the default variables ImmyBot would supply for a script (a POST that computes/reads defaults — it does not run the script or change state). Body carries the script/context to evaluate; returns the resolved variable set.

[ImmyBot] Inspect a script and report whether it declares a PowerShell param() block (read-only static analysis via POST). Body carries the script source; returns a boolean/analysis result. No script is created or run.

[ImmyBot] Execute a script against target computers/tenants. This RUNS PowerShell/metascript code on managed endpoints and can change system state — flagged Destructive so it requires explicit approval. Body carries the script reference, target selection, and parameters. Preview/validate first with immy_scripts_syntax_check and immy_scripts_validate_param_block_parameters.

[ImmyBot] Execute an ad-hoc metascript (inline PowerShell/metascript code, not a saved script) against targets. This RUNS arbitrary code on managed endpoints and can change system state — flagged Destructive so it requires explicit approval. Body carries the metascript source, target selection, and parameters.

[ImmyBot] Enable or disable a preflight script. Body carries the script identifier and desired enabled state. Changes which preflight checks run before maintenance — a configuration write. Use immy_list_scripts_disabled_preflight_scripts to see current state.

[ImmyBot] Static syntax check of a script (a POST that parses and returns diagnostics — it does not run the script). Body carries the script source; returns parse errors/warnings.

[ImmyBot] Validate a set of parameters against a script's param() block (read-only validation via POST — it checks, it does not persist anything). Body carries the param block and candidate parameter values; returns validation results. Note: immy_users_invalidate_cache is a DIFFERENT, write operation despite the similar name.

[ImmyBot] Create a new global script (shared platform-wide). Body carries the script name, source, and metadata. Validate the source first with immy_scripts_syntax_check.

[ImmyBot] Create a new local script (tenant-scoped). Body carries the script name, source, and metadata. Validate the source first with immy_scripts_syntax_check.

[ImmyBot] Permanently delete a global script. Any maintenance task or deployment referencing it loses that script — this cannot be undone. scriptId comes from immy_list_scripts_global; check immy_list_scripts_global_references first.

[ImmyBot] Permanently delete a local script. Any maintenance task or deployment referencing it loses that script — this cannot be undone. scriptId comes from immy_list_scripts_local; check immy_list_scripts_local_references first.

[ImmyBot] Get a single global script by id, including its source and metadata. scriptId comes from immy_list_scripts_global.

[ImmyBot] Get a single local script by id, including its source and metadata. scriptId comes from immy_list_scripts_local.

[ImmyBot] List scripts via the DevExtreme grid feed (the data source behind the ImmyBot scripts grid). Uses DevExtreme paging: skip/take (take clamped to 100) plus optional filter/sort and requireTotalCount. For a standard list use immy_list_scripts_global or immy_list_scripts_local.

[ImmyBot] List global scripts (shared platform-wide). Sieve-paged (Page/pageSize/Filters/Sorts); pageSize is clamped to 100. Each entry carries a scriptId used by immy_get_scripts_global, immy_update_global_script, and immy_delete_scripts_global.

[ImmyBot] List the audit history (change events) for a global script. scriptId comes from immy_list_scripts_global. Sieve-paged (Page/pageSize/Filters/Sorts); pageSize is clamped to 100. Use immy_list_scripts_global_audit_summaries for a rolled-up view.

[ImmyBot] List rolled-up audit summaries for a global script (aggregated change events). scriptId comes from immy_list_scripts_global. Sieve-paged (Page/pageSize/Filters/Sorts); pageSize is clamped to 100.

[ImmyBot] List just the id+name pairs of global scripts (a lightweight pick-list for referencing scripts). Sieve-paged (Page/pageSize/Filters/Sorts); pageSize is clamped to 100.

[ImmyBot] List the entities (maintenance tasks, deployments, etc.) that reference a global script. scriptId comes from immy_list_scripts_global. Sieve-paged (Page/pageSize/Filters/Sorts); pageSize is clamped to 100. Check references before deleting with immy_delete_scripts_global.

[ImmyBot] List local scripts (tenant-scoped). Sieve-paged (Page/pageSize/Filters/Sorts); pageSize is clamped to 100. Each entry carries a scriptId used by immy_get_scripts_local, immy_update_local_script, and immy_delete_scripts_local.

[ImmyBot] List the audit history (change events) for a local script. scriptId comes from immy_list_scripts_local. Sieve-paged (Page/pageSize/Filters/Sorts); pageSize is clamped to 100. Use immy_list_scripts_local_audit_summaries for a rolled-up view.

[ImmyBot] List rolled-up audit summaries for a local script (aggregated change events). scriptId comes from immy_list_scripts_local. Sieve-paged (Page/pageSize/Filters/Sorts); pageSize is clamped to 100.

[ImmyBot] Get the authorization (who may view/run/edit) for a local script. scriptId comes from immy_list_scripts_local. Set authorization with immy_scripts_local_authorization.

[ImmyBot] Preview what would happen if a local script were migrated to a global script (a read-only what-if — nothing is migrated). scriptId comes from immy_list_scripts_local. Perform the migration with immy_scripts_local_migrate_local_to_global.

[ImmyBot] List just the id+name pairs of local scripts (a lightweight tenant-scoped pick-list). Sieve-paged (Page/pageSize/Filters/Sorts); pageSize is clamped to 100.

[ImmyBot] List the entities that reference a local script. scriptId comes from immy_list_scripts_local. Sieve-paged (Page/pageSize/Filters/Sorts); pageSize is clamped to 100. Check references before deleting with immy_delete_scripts_local.

[ImmyBot] Get the reference counts for scripts (how many maintenance tasks/deployments reference each script). No parameters. Use immy_list_scripts_global_references / immy_list_scripts_local_references for the detailed referencing entities of one script.

[ImmyBot] Search across scripts (global + local) by keyword. Sieve-paged (Page/pageSize/Filters/Sorts); pageSize is clamped to 100.

[ImmyBot] Duplicate an existing script into a new script. Body carries the source scriptId and any new-script overrides (e.g. name). Creates a new script — a write.

[ImmyBot] Set the authorization (who may view/run/edit) for a local script. scriptId comes from immy_list_scripts_local; body carries the authorization grants. Read current state with immy_list_scripts_local_authorization.

[ImmyBot] Migrate a local (tenant-scoped) script to a global (platform-wide) script. scriptId comes from immy_list_scripts_local; body carries migration options. Preview the effect first with immy_list_scripts_local_migrate_local_to_global_what_if.

[ImmyBot] Update an existing global script (POST-based update, not a PATCH). scriptId comes from immy_list_scripts_global; body carries the updated script fields. Validate the source first with immy_scripts_syntax_check.

[ImmyBot] Update an existing local script (POST-based update, not a PATCH). scriptId comes from immy_list_scripts_local; body carries the updated script fields. Validate the source first with immy_scripts_syntax_check.

[ImmyBot] Permanently delete a deployment (target assignment) by its id (from immy_list_target_assignments). This removes the deployment and cannot be undone.

[ImmyBot] Permanently delete a global (cross-tenant) deployment by its id (from immy_list_target_assignments_global). This removes the deployment from every tenant it applied to and cannot be undone.

[ImmyBot] Get the optional (opt-in) deployment approvals available for a specific computer, by computerId (from immy_list_computers). Optional deployments require per-computer approval before they run; this shows which are pending/available. Grant one with immy_target_assignments_optional_target_assignment_approvals.

[ImmyBot] Get a single deployment (target assignment) by its id (from immy_list_target_assignments). Returns the full deployment definition — maintenance item, targets, desired state, schedule, and scope.

[ImmyBot] Get a single global (cross-tenant) deployment by its id (from immy_list_target_assignments_global). Returns the full deployment definition.

[ImmyBot] List deployments (target assignments) across the ImmyBot instance. A deployment binds a maintenance item (software/task/script) to targets (tenant, tag, computer, person, or MSP). Supports Sieve paging and filtering (Page, pageSize up to 100, Filters, Sorts). Use immy_get_target_assignments for one deployment, immy_list_target_assignments_global for cross-tenant deployments.

[ImmyBot] List global (cross-tenant) deployments — target assignments that apply across every tenant rather than to a single one. Supports Sieve paging (Page, pageSize up to 100, Filters, Sorts). Use immy_get_target_assignments_global for one global deployment.

[ImmyBot] Get the maintenance-item type (software / maintenance task / script) of a global deployment by its id (from immy_list_target_assignments_global). Lightweight lookup used to disambiguate which item family the deployment targets.

[ImmyBot] List the ordering of maintenance items as resolved by deployments — the sequence in which items run during maintenance. Supports Sieve paging (Page, pageSize up to 100, Filters, Sorts). Change the order with immy_target_assignments_update_maintenance_item_order.

[ImmyBot] List recommended deployment approvals — deployments ImmyBot recommends approving based on current state. Supports Sieve paging (Page, pageSize up to 100, Filters, Sorts). Apply the recommendations with immy_target_assignments_recommended_approvals_update.

[ImmyBot] Get the maintenance-item type (software / maintenance task / script) of a deployment by its id (from immy_list_target_assignments). Lightweight lookup used to disambiguate which item family the deployment targets.

[ImmyBot] Batch-update multiple deployments in one call. Provide a JSON body containing the set of deployments and the fields to change on each. Use for bulk edits instead of many immy_update_target_assignments calls.

[ImmyBot] Preview (what-if, no changes made) migrating deployments onto a superseding target assignment — shows what would happen without applying it. POST-as-read: provide a JSON body describing the migration (source deployments and superseding target). Apply for real with immy_target_assignments_migrate_to_superseding_assignment.

[ImmyBot] Create a new deployment (target assignment). Provide a JSON object body defining the maintenance item, targets (tenant/tag/computer/person/MSP), desired state, and schedule. Preview the resolved targets first with immy_target_assignments_target_preview / _tenant_target_preview / _persons_target_preview.

[ImmyBot] Duplicate a single deployment (target assignment) into a new one. Provide a JSON body identifying the source deployment and any overrides for the copy. See immy_target_assignments_duplicates to duplicate several at once.

[ImmyBot] Duplicate multiple deployments (target assignments) in one call. Provide a JSON body identifying the source deployments and any overrides. See immy_target_assignments_duplicate for a single copy.

[ImmyBot] Create a new global (cross-tenant) deployment. Provide a JSON object body defining the maintenance item, cross-tenant targets, desired state, and schedule. List existing global deployments with immy_list_target_assignments_global.

[ImmyBot] Set or update the notes on a global (cross-tenant) deployment by its id (from immy_list_target_assignments_global). Provide a JSON body containing the notes text.

[ImmyBot] Apply an override to a global (cross-tenant) deployment by its id (from immy_list_target_assignments_global). Provide a JSON body describing the override (e.g. a tenant-level exception to the cross-tenant deployment).

[ImmyBot] Migrate deployments so their targeting is driven by provider-link (RMM/PSA integration) data instead of legacy targeting. Provide a JSON body identifying the deployments and target provider links.

[ImmyBot] Migrate deployments onto a superseding target assignment (applies the change). Provide a JSON body identifying the source deployments and the superseding target. Preview first with immy_target_assignment_migrate_to_superseding_what_if.

[ImmyBot] Set or update the notes on a deployment (target assignment) by its id (from immy_list_target_assignments). Provide a JSON body containing the notes text.

[ImmyBot] Approve (opt in) an optional deployment for a target, by the optional-approval id. Provide a JSON body with the approval decision. Discover available approvals with immy_get_computer_optional_target_assignment_approvals.

[ImmyBot] Apply an override to a deployment (target assignment) by its id (from immy_list_target_assignments). Provide a JSON body describing the override (e.g. a per-computer or per-tenant exception to the deployment).

[ImmyBot] Preview which persons a deployment target would resolve to (no changes made). POST-as-read: provide a JSON body describing the target criteria; returns the matching persons. See immy_target_assignments_target_preview (computers) and immy_target_assignments_tenant_target_preview (tenants).

[ImmyBot] Apply recommended deployment approvals. Provide a JSON body selecting which of the recommendations to approve/reject. List the recommendations first with immy_list_target_assignments_recommended_approvals.

[ImmyBot] Preview which computers a deployment target would resolve to (no changes made). POST-as-read: provide a JSON body describing the target criteria; returns the matching computers. See immy_target_assignments_tenant_target_preview and immy_target_assignments_persons_target_preview for tenant/person previews.

[ImmyBot] Preview which tenants a deployment target would resolve to (no changes made). POST-as-read: provide a JSON body describing the target criteria; returns the matching tenants. See immy_target_assignments_target_preview (computers) and immy_target_assignments_persons_target_preview (persons).

[ImmyBot] Update the run order of maintenance items resolved by deployments. Provide a JSON body containing the desired ordering. View the current order with immy_list_target_assignments_maintenance_item_orders.

[ImmyBot] Set the visibility of deployments (e.g. hide/show in tenant-facing views). Provide a JSON body identifying the deployments and the visibility setting.

[ImmyBot] Update (replace) a deployment (target assignment) by its id (from immy_list_target_assignments). Provide the full JSON deployment definition — this is a PUT/replace, so include all fields you want to keep. For bulk edits use immy_patch_target_assignments_batch_update.

[ImmyBot] Update (replace) a global (cross-tenant) deployment by its id (from immy_list_target_assignments_global). Provide the full JSON deployment definition — this is a PUT/replace, so include all fields you want to keep.

[ImmyBot] Apply a deployment change request by its changeRequestId (from immy_list_target_assignment_change_requests) — commits the proposed deployment edits. Provide a JSON body with any apply options. Review the diff (immy_list_target_assignments_change_request_diff) before applying.

[ImmyBot] Create an instance-wide deployment change request — a reviewable proposal of deployment edits. Provide a JSON body describing the proposed changes. Review its diff with immy_list_target_assignments_change_request_diff, then apply with immy_apply_change_request.

[ImmyBot] Create a change request scoped to a single deployment, by deploymentId (from immy_list_target_assignments). Provide a JSON body describing the proposed change to that deployment. List a deployment's change requests with immy_list_deployment_change_requests.

[ImmyBot] Get a single deployment change request by its changeRequestId (from immy_list_target_assignment_change_requests). Returns the proposed change to a deployment. Inspect what it would alter with immy_list_target_assignments_change_request_diff.

[ImmyBot] List the change requests scoped to a single deployment, by deploymentId (from immy_list_target_assignments). Supports Sieve paging (Page, pageSize up to 100, Filters, Sorts). Create one with immy_create_deployment_change_request.

[ImmyBot] List deployment change requests across the instance. Supports Sieve paging (Page, pageSize up to 100, Filters, Sorts). For change requests scoped to one deployment use immy_list_deployment_change_requests.

[ImmyBot] Get the diff of a deployment change request by its changeRequestId (from immy_list_target_assignment_change_requests) — the before/after of what applying it would change. Review this before immy_apply_change_request.

[ImmyBot] Update an existing change request scoped to a deployment, by deploymentId and changeRequestId (both from immy_list_deployment_change_requests). Provide a JSON body with the revised proposed change.

[ImmyBot] DevExtreme grid feed of maintenance actions scoped to a single computer. Pass the computerId (from immy_list_computers). Uses skip/take paging (take max 100) plus optional DevExtreme filter/sort JSON and requireTotalCount. Returns raw ImmyBot JSON.

[ImmyBot] Get the latest maintenance actions for a single computer (from immy_list_computers). Returns raw ImmyBot JSON.

[ImmyBot] Get the latest maintenance actions for a single tenant (from immy_list_tenants). Returns raw ImmyBot JSON.

[ImmyBot] Get the latest non-compliant maintenance actions (action still required) for a single tenant (from immy_list_tenants). Returns raw ImmyBot JSON.

[ImmyBot] List the maintenance actions on one computer that currently need attention (non-compliant / action required). Pass the computerId (from immy_list_computers). Sieve-paginated: Page + pageSize (max 100) + optional Filters/Sorts. Returns raw ImmyBot JSON.

[ImmyBot] DevExtreme grid feed of maintenance actions across the instance. Uses skip/take paging (take max 100) plus optional DevExtreme filter/sort JSON and requireTotalCount. Returns raw ImmyBot JSON.

[ImmyBot] List the execution logs for a single maintenance action. Pass the actionId (from a maintenance-actions listing or a session's actions). Sieve-paginated: Page + pageSize (max 100) + optional Filters/Sorts. Returns raw ImmyBot JSON.

[ImmyBot] List maintenance actions grouped/filtered by maintenance item (software or task). Sieve-paginated: Page + pageSize (max 100) + optional Filters/Sorts. Returns raw ImmyBot JSON.

[ImmyBot] Get the maintenance-actions version/metadata record used by the ImmyBot UI grid. Returns raw ImmyBot JSON.

[ImmyBot] Look up the latest maintenance action for a set of computers for one software item or maintenance task. This is a POST-as-read (read-only): provide a JSON object body — required: maintenanceIdentifier (string). Optional: maintenanceType ('Software' or 'MaintenanceTask'; must accompany maintenanceIdentifier), computerIds (array of computer ids), dateUtc (ISO timestamp to look back from). Returns raw ImmyBot JSON.

[ImmyBot] Look up the latest maintenance action for a set of tenants for one software item or maintenance task. This is a POST-as-read (read-only): provide a JSON object body — required: maintenanceIdentifier (string). Optional: maintenanceType ('Software' or 'MaintenanceTask'; must accompany maintenanceIdentifier), tenantIds (array of tenant ids), dateUtc (ISO timestamp to look back from). Returns raw ImmyBot JSON.

[ImmyBot] Cancel ALL currently-running maintenance sessions across the instance. Destructive and broad — it aborts every in-progress session; get user approval first. Takes no meaningful body (leave fieldsJson as ``). Returns raw ImmyBot JSON.

[ImmyBot] Cancel a single maintenance session by sessionId. Destructive — it aborts the in-progress session. This is a GET-verb action endpoint (not a read); pass the sessionId (from immy_list_maintenance_sessions_dx). Returns raw ImmyBot JSON.

[ImmyBot] Cancel a specific set of running maintenance sessions. Destructive — it aborts in-progress maintenance. Provide a JSON object body: sessionIds (array of maintenance session ids from immy_list_maintenance_sessions_dx). Returns raw ImmyBot JSON.