> ## Documentation Index
> Fetch the complete documentation index at: https://composio-preview.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Pilvio

> Pilvio is a cloud service provider offering virtual machines, object storage, and full API support for resource management and automation.

![Pilvio logo](https://mintcdn.com/composio-preview/gqjBKmmJCINafaiK/images/toolkits/pilvio.svg?fit=max\&auto=format\&n=gqjBKmmJCINafaiK\&q=85\&s=3cc358568274fd07b6cd7556dd2b5e85)

* **Category:** developer tools
* **Auth:** API\_KEY
* **Composio-managed OAuth available?** N/A
* **Tools:** 10
* **Triggers:** 0
* **Slug:** `PILVIO`
* **Version:** 20261101\_00

## Tools

> [accordion] Check Active Campaigns
>
> **Slug:** `PILVIO_CHECK_ACTIVE_CAMPAIGNS`
>
> Tool to check for active campaigns. Use when you need to verify whether any campaigns are currently active.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get User Info
>
> **Slug:** `PILVIO_GET_USER_INFO`
>
> Tool to retrieve information about the authenticated user. Use when you need to fetch the current user's profile after authentication.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List billing accounts
>
> **Slug:** `PILVIO_LIST_BILLING_ACCOUNTS`
>
> Tool to list billing accounts. Use when you need to fetch all billing accounts for management or reporting. Use after authenticating your Pilvio API key.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Credit Cards
>
> **Slug:** `PILVIO_LIST_CREDIT_CARDS`
>
> Tool to list credit cards attached to a billing account. Use after confirming the billing account ID. Example: "Retrieve cards for billing\_account\_id 'ba\_1234567890abcdef'."
>
> #### Input Parameters
>
> **billing\_account\_id** `string` *required*
>
> Path parameter. The ID of the billing account to list credit cards for.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Invoices
>
> **Slug:** `PILVIO_LIST_INVOICES`
>
> List invoices for a specified Pilvio billing account. Optional status, date, limit, and offset parameters can be sent with the request to narrow or paginate the results.
>
> #### Input Parameters
>
> **limit** `integer`
>
> Number of invoices per page.
>
> **offset** `integer`
>
> Pagination offset (zero-based).
>
> **status** `string ("paid" | "unpaid" | "pending")`
>
> Filter invoices by status.
>
> **date\_to** `string`
>
> ISO 8601 timestamp (inclusive) to filter invoices created on or before this date.
>
> **date\_from** `string`
>
> ISO 8601 timestamp (inclusive) to filter invoices created on or after this date.
>
> **billing\_account\_id** `string` *required*
>
> Billing account ID to retrieve invoices for.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Pilvio data center locations
>
> **Slug:** `PILVIO_LIST_LOCATIONS`
>
> Tool to retrieve the list of available data center locations. Use after authentication to see where you can deploy resources.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List VM Resource Pools
>
> **Slug:** `PILVIO_LIST_VM_RESOURCE_POOLS`
>
> List available Pilvio VM resource pools to help determine where to provision compute resources. The request accepts optional page and page-size parameters.
>
> #### Input Parameters
>
> **page** `integer`
>
> Page number for pagination (1-based)
>
> **page\_size** `integer`
>
> Number of items per page
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Virtual Machines
>
> **Slug:** `PILVIO_LIST_VMS`
>
> List the authenticated user's virtual machines in the default Pilvio location. Use the results to inspect the VMs available in that location; this does not list VMs across all locations.
>
> #### Input Parameters
>
> **sort** `string`
>
> Sort by field
>
> **limit** `integer`
>
> Maximum results per page
>
> **offset** `integer`
>
> Pagination offset
>
> **project\_id** `string`
>
> Filter by project id
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List VM Snapshots
>
> **Slug:** `PILVIO_LIST_VM_SNAPSHOTS`
>
> List replicas for a specific VM, selecting snapshots by default or another replica type such as backups. Unexpected response formats can be returned as an empty list.
>
> #### Input Parameters
>
> **uuid** `string` *required*
>
> UUID of the VM to fetch replicas/snapshots for
>
> **r\_type** `string`
>
> Type of replica to list: 'snapshot' or 'backup'. Defaults to 'snapshot'
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update User Profile
>
> **Slug:** `PILVIO_UPDATE_USER_PROFILE`
>
> Tool to update the authenticated user's profile. Use after obtaining a valid API key when you need to modify profile details (e.g., change email or name).
>
> #### Input Parameters
>
> **email** `string`
>
> User's email address
>
> **username** `string` *required*
>
> User's username (required for identification)
>
> **last\_name** `string`
>
> User's last name
>
> **first\_name** `string`
>
> User's first name
>
> **phone\_number** `string`
>
> User's phone number
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not
