pilvio

name

pilvio

description

Pilvio is a cloud-based field service management platform that provides scheduling, dispatching, work order tracking, and mobile tools, allowing service teams and contractors to manage on-site operations, technician workflows, and customer service processes more efficiently. Read and write Pilvio data through One: virtualmachine, loadbalancers, network, floatingip, payment, billingaccount and more, 111 actions with real parameter documentation. Use whenever the user asks to look something up in Pilvio, create or update a record there, or build code against the Pilvio API.

Pilvio through One

Pilvio is a cloud-based field service management platform that provides scheduling, dispatching, work order tracking, and mobile tools, allowing service teams and contractors to manage on-site operations, technician workflows, and customer service processes more efficiently.

One exposes Pilvio through four MCP tools. The table below carries real action ids from One's knowledge base, so for a common operation you can skip search and go straight to reading the action's parameters.

How to run an action

1. Find the action in the table below, or call search_one_platform_actions with platform pilvio if it is not listed.
2. Call get_one_action_knowledge with the action id. Do this every time, including for actions in this table. The table gives you the id, not the parameters.
3. Call execute_one_action with parameters copied from that knowledge.

Never guess a parameter name, a body field, or an enum value. The knowledge has the real schema, and a guessed field is either a 400 or a silent write of the wrong thing.

Before you start

Call list_one_integrations once and confirm Pilvio is connected. If it is missing, the user has not connected it: say so and point them at https://app.withone.ai rather than reaching for raw HTTP.

Each connection carries an access field. If it reports {"policy": "methods", "methods": ["GET"]} the agent is read-only here, so plan a read-only answer instead of attempting a write that will be refused.

Before a write

Creates, updates, deletes and sends land on a real Pilvio account and cannot be recalled. State the action and the specific target in one line before the first write in a task, and let the user stop you. Reads need no confirmation.

Actions

VirtualMachine

Action	Method	Path	Action id
Get Virtual Machine Data	GET	/user-resource/vm	conn_mod_def::GLGDIr7K87g::CMKtX4ALTW--HsVvBNhRtg
Clone an Existing Virtual Machine	POST	/v1/user-resource/vm/clone	conn_mod_def::GLGDIhZHuxg::iKlaM-xgRJSywaupkY2PzQ
Create a Virtual Machine	POST	/v1/user-resource/vm	conn_mod_def::GLGDIhHhmgg::O-wvEk7eRN-iloXlL7fekg
Delete a Virtual Machine	DELETE	/v1/user-resource/vm	conn_mod_def::GLGDIqvAvtg::jJCoXcqLSCysbkZKwdhEdw
Rebuild a Virtual Machine from a Replica	POST	/v1/user-resource/vm/rebuild	conn_mod_def::GLGDI1JXWhg::Oox6x2YxRCykNgVZj3hP5g
Reinstall a Virtual Machine	POST	/v1/user-resource/vm/reinstall	conn_mod_def::GLGDI-Mm0vg::BDfRpu-gTvC4XpDihHfe3Q
Start Virtual Machine	POST	/v1/user-resource/vm/start	conn_mod_def::GLGDI-1RDtg::nT7yeY5JSOWfT40_WTA-4w
Stop a Virtual Machine	POST	/v1/user-resource/vm/stop	conn_mod_def::GLGDI_xAh3A::CVruFgf9TMW5DpGleauOWw
Toggle Automatic Backups for a Virtual Machine	POST	/v1/user-resource/vm/backup	conn_mod_def::GLGDJJchaLg::pEcMulVOSKWUeuDVzcs4EA

LoadBalancers

Action	Method	Path	Action id
Get a User Load Balancer by UUID	GET	/network/load_balancers/{{loadBalancerUuid}}	conn_mod_def::GLGDGoi0bjg::vgcAUMPIQzWAKbwQ2iIghw
List Load Balancers	GET	/v1/network/load_balancers	conn_mod_def::GLGDGqdJ1lg::hYYErcG0SdObzPugAlVojQ
Change a Load Balancer's Billing Account	PUT	/network/load_balancers/{{lbUuid}}/billing_account	conn_mod_def::GLGDGf8n6-A::PaDO_FWpRkOLtZhl2mosBA
Delete a Load Balancer	DELETE	/network/load_balancers/{{loadBalancerId}}	conn_mod_def::GLGDGgGBtng::jv5dsBohTE60sImk4JLYiQ
Unlink Target from a Load Balancer	DELETE	/network/load_balancers/{{lbUuid}}/targets/{{targetUuid}}	conn_mod_def::GLGDGo6c_RA::merlHafESiOzHrzaP_6EAQ

Network

Action	Method	Path	Action id
Get Network Data	GET	/network/network/{{networkUuid}}	conn_mod_def::GLGDIDgxxvg::smU9XrBJTNaonueguOyhuQ
Change a Network Name	PATCH	/network/network/{{networkUuid}}	conn_mod_def::GLGDH6RRIjA::QE-DW1klQkq8hhlzUwLSsQ
Create a Network	POST	/network/network	conn_mod_def::GLGDIDfzK6A::ckQAsCP6QzWhYaUM9swHWA
Delete a Network	DELETE	/network/network/{{networkUuid}}	conn_mod_def::GLGDIEFnF6A::Hu_18BwoRnOnA2Rx68imFg
Set a Network as the Default Network	PUT	/network/network/{{networkUuid}}/default	conn_mod_def::GLGDH55gF3g::-D7VGySzQYaDeRscLcGzoQ

FloatingIp

Action	Method	Path	Action id
Get a Floating IP by Public IPv4 Address	GET	/network/ip_addresses/{{publicIpv4Address}}	conn_mod_def::GLGDGWzhxQg::520ZUm5dRoqt1LBeHJgt-w
Create New Floating IP	POST	/network/ip_addresses	conn_mod_def::GLGDGKLwH2A::AZroiTx8SQiXpsv_DvrZmA
Un-assign a Floating IP	POST	/network/ip_addresses/{{publicIpv4Address}}/unassign	conn_mod_def::GLGDGTtewFg::-l2dF0oiQSOHajQocD6CAA
Update a Floating IP by Public IPv4 Address	PATCH	/network/ip_addresses/{{publicIpv4Address}}	conn_mod_def::GLGDGUAp6LA::rIvervBZQ86Ew6D_BBlZ_Q

Payment

Action	Method	Path	Action id
Apply for Invoice Payment	POST	/payment/apply_for_invoice_payment	conn_mod_def::GLGDHR5gjZg::qZILm74LQ5-TStGNmU8ZRg
Pay All Billing Account Invoices	POST	/payment/pay_all	conn_mod_def::GLGDHmRq8CA::jsYt_Vz4SLCPNDpu1M85Xw
Pay an Amount	POST	/payment/pay_amount	conn_mod_def::GLGDHyJvuog::t9nfSLORTxSc8cq4ZlTg7g
Pay Invoice	POST	/payment/pay_invoice	conn_mod_def::GLGDHtyG0Sg::99RNckDdRYybX_VQ4huX6w

BillingAccount

Action	Method	Path	Action id
Get a Billing Account	GET	/v1/payment/billing_account	conn_mod_def::GLGDHRtMHcA::MoLO3bbVSeSyWhXvB8CLAA
Delete a Billing Account	DELETE	/v1/payment/billing_account	conn_mod_def::GLGDHaVknAg::4kOpNvblTz6eIF7o74qp5w
Set Default Billing Account	POST	/v1/payment/billing_account/set_default	conn_mod_def::GLGDH7y681A::D2FrqGP7QJeKhniV6_hLmw
Update Billing Account	PUT	/v1/payment/billing_account	conn_mod_def::GLGDH5UtboA::HhpTnmsGRPqmAdrXy83FcA

VirtualMachineStorage

Action	Method	Path	Action id
Attach Storage to a Virtual Machine	POST	/v1/user-resource/vm/storage/attach	conn_mod_def::GLGDFlh5U5A::zjbH7CKAQTK6GIW3gVBErQ
Create and Add Storage to a Virtual Machine	POST	/user-resource/vm/storage	conn_mod_def::GLGDIW0h-Rg::GMF2IGabTHCN3IWbsN0Fug
Detach Storage From a Virtual Machine	POST	/v1/user-resource/vm/storage/detach	conn_mod_def::GLGDF2h0nYA::G07xba9IQPqIaT-R5NaaJA
Modify a Virtual Machine Disk's Capacity	PATCH	/v1/user-resource/vm/storage	conn_mod_def::GLGDI25ZSgA::n_SJ_05NQVucEnDakWrUxA

StorageBucket

Action	Method	Path	Action id
Create a Storage Bucket	PUT	/storage/bucket	conn_mod_def::GLGDGx0hUVg::J2i0FmhgQgWqyltxCin4VA
Delete an S3 Object Storage Bucket	DELETE	/storage/bucket	conn_mod_def::GLGDGyfAlig::2E_YAfLqS_uCQaxjhoW6hQ
Modify a Storage Bucket's Billing Account	PATCH	/v1/storage/bucket	conn_mod_def::GLGDG6Uw0KA::MF2-QDYfQry4O1Wl6MeLMw

Firewalls

Action	Method	Path	Action id
List Firewalls	GET	/network/firewalls	conn_mod_def::GLGDGBUDsdA::hsr7XtH2QleYb_i-vu5Yug
Create a Firewall	POST	/v1/network/firewalls	conn_mod_def::GLGDGB6KFGA::ul71DRXGS3SLIkLz7v7fDA
Delete a Firewall	DELETE	/network/firewalls/{{firewallUuid}}	conn_mod_def::GLGDGA58pMA::yphcIEjNQbm7Jk_Lfnub4g

Disks

Action	Method	Path	Action id
Get One Disk	GET	/storage/disks/{{diskUuid}}	conn_mod_def::GLGDF104syA::v65379VnSjW0Lylbgs3DFA
List User's Disks	GET	/storage/disks	conn_mod_def::GLGDF25svLg::NBsdb3NNS3W7EHKtmJtCSw
Modify a Disk	PATCH	/storage/disks/{{diskUuid}}	conn_mod_def::GLGDF12p81A::4pPVuEIVTM6K8gu8-2fIuQ

PaymentCard

Action	Method	Path	Action id
Add a Credit Card to a Billing Account	POST	/payment/card	conn_mod_def::GLGDHRGAVZA::AFtd1CUwSgiMvHR5XYu8Ow
Remove Credit Card	DELETE	/v1/payment/card	conn_mod_def::GLGDHvto6hg::IJfrxjqKRF-cT1utzWvpFw
Set Primary Payment Card	PUT	/v1/payment/card/set_primary	conn_mod_def::GLGDHuDIfjA::qmwCOj-rSY6wrEXcFEeP5A

SshKeys

Action	Method	Path	Action id
List SSH Public Keys	GET	/user-resource/ssh_keys	conn_mod_def::GLGDIUoJCJA::pJmZjdqNTImbZfzOlsM61Q
Delete an SSH Key by UUID	DELETE	/user-resource/ssh_keys/{{uuid}}	conn_mod_def::GLGDILlomqg::tgN7k0FrR3uq-kF0S94OiA
Rename an SSH Key	PATCH	/user-resource/ssh_keys/{{uuid}}	conn_mod_def::GLGDIVdljOg::LUoptj4YTiKyFj857om31g

Vm

Action	Method	Path	Action id
Boot a VM from ISO Media	POST	/v1/user-resource/vm/boot_iso_media	conn_mod_def::GLGDIhjfF2g::-C3kFnegTBG6MXOirzmBZw
Update a VM	PATCH	/v1/user-resource/vm	conn_mod_def::GLGDIzHUnQA::PPieS7QRTHWqcgqYs-TUxA

VmReplica

Action	Method	Path	Action id
Create replica from block storage	POST	/v1/user-resource/vm/replica	conn_mod_def::GLGDIinqNHA::ZP4BgCdmT--3uFiOOqwQIA
Delete a VM Replica	DELETE	/user-resource/vm/replica	conn_mod_def::GLGDIqp9p-g::m68LrSa-SfuVFslMImsW5w

VirtualMachines

Action	Method	Path	Action id
List Virtual Machines	GET	/v1/user-resource/vm/list	conn_mod_def::GLGDI1I_ytg::oSNURGZAQVW-ffmt2neB5w
Release a Virtual Machine's Public IPv4 Address	DELETE	/v1/user-resource/vm/ip/public	conn_mod_def::GLGDI_9XArg::hMhNOc6GS5OJylLRGWPILw

StorageDisks

Action	Method	Path	Action id
Create a Storage Disk	POST	/v1/storage/disks	conn_mod_def::GLGDFuNOAaA::o9Nmd-y6R46qiubMHn2-qA
Delete a Storage Disk by UUID	DELETE	/storage/disks/{{diskUuid}}	conn_mod_def::GLGDFl2vCUA::1G81nI-HR-aeRokt3C393g

LoadBalancerForwardingRules

Action	Method	Path	Action id
Add a Load Balancer Forwarding Rule	POST	/network/load_balancers/{{loadBalancerId}}/forwarding_rules	conn_mod_def::GLGDGghI4Zg::m0xMa2YQTwK06lShd84gTg
Delete a Load Balancer Forwarding Rule	DELETE	/network/load_balancers/{{lbUuid}}/forwarding_rules/{{ruleUuid}}	conn_mod_def::GLGDGoxrHTg::3JJr1OacTnqht1p17BecjQ

FirewallAssociations

Action	Method	Path	Action id
Remove a Firewall Association from a Virtual Machine	DELETE	/network/firewalls/{{firewallUuid}}/vms	conn_mod_def::GLGDGLj_amg::XlTcATKVQGiuUV3pSjPHPQ

Locations

Action	Method	Path	Action id
List Locations	GET	/v1/config/locations	conn_mod_def::GLGDGUsqMXA::bb-HXwYMQR-jm3PAjmQBeQ

FloatingIps

Action	Method	Path	Action id
List Floating IPs	GET	/network/ip_addresses	conn_mod_def::GLGDGVTx3tg::JzaMr4rNRXqv6By0SGXv_A

StorageUser

Action	Method	Path	Action id
Get Storage User Info	GET	/storage/user	conn_mod_def::GLGDG50YH0A::yqJ5ydA7TNKaNqyGA47qhw

AppCatalogVmImages

Action	Method	Path	Action id
List App Catalog VM Images	GET	/v1/config/vm_images/app_catalog	conn_mod_def::GLGDHEZtlDA::vog5IDwLQFCD9NwYARaw7g

VmCreationParameters

Action	Method	Path	Action id
List VM Creation Parameters	GET	/v1/api/parameters/vm	conn_mod_def::GLGDHErdQpA::wMhXqHMoTGmWbnfCftJGig

VmImages

Action	Method	Path	Action id
List VM Images	GET	/config/vm_images	conn_mod_def::GLGDHJXJnnA::5cxeKGqySueFou9huCkZyg

CreditTopUpInvoice

Action	Method	Path	Action id
Request a Credit Top-Up Invoice	POST	/v1/payment/credit/request_invoice	conn_mod_def::GLGDHwZD5_g::-5Z_kPwlTsuSMuXt5sdrSA

VirtualMachineStorageReplicas

Action	Method	Path	Action id
Get Virtual Machine Storage Replica List	GET	/user-resource/vm/replica	conn_mod_def::GLGDIrBCR4g::vVtwDWmzRDSROcOGu2opbQ

VmStorageDisk

Action	Method	Path	Action id
Delete a VM Storage Disk	DELETE	/v1/user-resource/vm/storage	conn_mod_def::GLGDIr7pzig::PRWdBAHPSSim80c1VdOdvA

HostPools

Action	Method	Path	Action id
List Host Pools	GET	/user-resource/host_pool/list	conn_mod_def::GLGDIzSOmJg::JD0RcTjfQ56qX6Ey8kv35g

BootImages

Action	Method	Path	Action id
List Boot Images	GET	/v1/config/boot_images	conn_mod_def::GLGDHC34o2g::1rx_lQ-MQNyllz-dbyQzNw

BillingAccountRecurringPayment

Action	Method	Path	Action id
Configure Recurring Payment for a Billing Account	PUT	/payment/billing_account/{{billingAccountId}}/recurring_payment	conn_mod_def::GLGDHbFDMvA::NHyJssUYQiOdsSYdhYhD4Q

PaymentCardDetails

Action	Method	Path	Action id
Get Payment Card Details	GET	/payment/card	conn_mod_def::GLGDHbHRMoA::3PlJhchZQvaP_Ls1jfd_cQ

Invoice

Action	Method	Path	Action id
Get Invoice Details	GET	/payment/invoice	conn_mod_def::GLGDHbRi7Wg::ZOvXe3TBQwW13CQh05gPjg

BillingResources

Action	Method	Path	Action id
List Billing Account Resources	GET	/user-resource/billing_resources	conn_mod_def::GLGDFl2m7wg::E6OA-gOrSTeFbVr641-VUg

UserResourceBilling

Action	Method	Path	Action id
Associate a Resource with a Billing Account	POST	/v1/user-resource/resource_billing	conn_mod_def::GLGDFqBKaZg::VyS_cqaFTOGtOAICVeo-wA

ChargingUsage

Action	Method	Path	Action id
Get Charging Usage for a Billing Account	GET	/charging/usage	conn_mod_def::GLGDF4HIvwA::gBa9FD8bS467AzmhbWY-KQ

FirewallRule

Action	Method	Path	Action id
Firewall Rule Object	POST	``	conn_mod_def::GLGDF_WEM-g::NBoClEKcSP6AUmH_fAehOg

FirewallVirtualMachines

Action	Method	Path	Action id
Associate a Firewall with a Virtual Machine	POST	/network/firewalls/{{firewallUuid}}/vms	conn_mod_def::GLGDGA6hOAg::PbTurTflQRmFynH5czzsgg

FloatingIpAddress

Action	Method	Path	Action id
Delete a Floating IP Address	DELETE	/network/ip_addresses/{{publicIpv4Address}}	conn_mod_def::GLGDGJsdBmg::hD1KDZBKRx24XNDJRkE3CQ

Firewall

Action	Method	Path	Action id
Update a Firewall	PUT	/network/firewalls/{{firewallUuid}}	conn_mod_def::GLGDGJ2m0hA::ezmiUtI-Q9ClFU4dzylhAw

IpAddresses

Action	Method	Path	Action id
Assign a Floating IP	POST	/network/ip_addresses/{{publicIpv4Address}}/assign	conn_mod_def::GLGDGKYDdfg::5W4ZbFzFQmy9eGveqQCQdQ

LoadBalancerTargets

Action	Method	Path	Action id
Add a New Target to a Load Balancer	POST	/network/load_balancers/{{loadBalancerId}}/targets	conn_mod_def::GLGDGgPZH7A::aUw1SlY0RhyMZX4OgU7rtw

NetworkLoadBalancers

Action	Method	Path	Action id
Create a Network Load Balancer	POST	/v1/network/load_balancers	conn_mod_def::GLGDGgzJGlg::pRN7EUWtQQWZ7L6oBaFWfg

LoadBalancer

Action	Method	Path	Action id
Rename a Load Balancer	PATCH	/network/load_balancers/{{loadBalancerUuid}}	conn_mod_def::GLGDGoixTXA::nIlplJBQQTiiV3ybBU2cJQ

BillingAccountUnpaidTotalAmount

Action	Method	Path	Action id
Get a Billing Account's Unpaid Total Amount	GET	/v1/payment/billing_account/unpaid_amount	conn_mod_def::GLGDHcKGQEg::EQZAxzSwQRi_LwpsyVk7Ug

UserStorageS3Keys

Action	Method	Path	Action id
Generate a User Storage S3 Key Pair	POST	/storage/user/keys	conn_mod_def::GLGDGyLDHug::euMijGBARduVMkuN4To1KA

UserStorageKeys

Action	Method	Path	Action id
Delete a User Storage Key	DELETE	/storage/user/keys	conn_mod_def::GLGDGyUc0hA::4p6IgKjRQ2mck4DYgvFP-A

Bucket

Action	Method	Path	Action id
Get Bucket Information	GET	/storage/bucket	conn_mod_def::GLGDGypNmgg::t-gl54eQTbyv05B4v9EvoQ

This lists 90 of 111 actions. For anything not here, call search_one_platform_actions with platform pilvio. The full catalog is at https://www.withone.ai/knowledge/pilvio.

When a call fails

The error comes from Pilvio, not from One. A 400 or 422 means your parameters do not match the schema, so re-read the knowledge and fix the field. A 401 or 403 means the connection needs re-authorizing, which no retry will fix. A 404 means the id is not on this account. A 429 means slow down. Never retry a write more than once: the first attempt may have landed.

Full catalog: https://www.withone.ai/knowledge/pilvio

Integration knowledge by One (withone.ai), licensed under One-Knowledge-1.0. Attribution must be preserved in derivative works.