Pia

Overview

Pia is an IT automation platform built for MSPs. It lets technicians and end users run prebuilt automations ("packages" and "SmartForms") that take actions across PSA, RMM, identity, and other tools.

The Bumblebee integration exposes Pia's three API surfaces as generic passthrough tools, so the agent can reach any endpoint and select the right path from each tool's documented endpoint catalog. This integration is currently a research preview.

Prerequisites & Setup

Before setting up the Pia integration, you need:

A Pia tenant
Administrator access to create an API app in that tenant
Your tenant URL (e.g. https://yourtenant.pia.ai)

Generate an App Secret

Sign in to your Pia tenant as an administrator
Create an API app in the tenant's API settings
Copy the App Secret — it is shown once at creation, so copy it immediately
Note your tenant base URL (the https://yourtenant.pia.ai host, with no trailing /api)

Configure in Bumblebee

Go to the Integrations page in Bumblebee
Select Pia
Enter your API URL (the tenant base URL) and App Secret
Save the configuration

Bumblebee authenticates each request with an Authorization: api <app_secret> header (the literal word api, a space, then the secret — not Bearer).

Available Tools

Each tool is a thin passthrough over one Pia API surface. Pass path (no leading slash, no host), an optional method (default GET), query_params, and a body for POST / PUT. The full endpoint catalog is enumerated in each tool's docstring.

Tool	Surface	What it does
call_build_endpoint	`/api/build/*`	Inspect repos and push/pull packages, activities, and forms.
call_automate_endpoint	`/api/automate/*`	Discover, trigger, and monitor automation executions.
call_configure_endpoint	`/api/config/*`	Manage agents (activate/deactivate/uninstall) and read clients.

Example calls

# List every published SmartForm in the tenant
call_automate_endpoint(path="api/automate/discover/smartforms/all")

# Trigger an automation against a specific PSA ticket
call_automate_endpoint(
    path="api/automate/trigger/abc-pkg-123/withTicket/T-9001",
    method="POST",
    body={"reason": "user requested password reset"},
)