# Pilvio

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

- **Category:** developer tools
- **Auth:** API_KEY
- **Composio Managed App Available?** N/A
- **Tools:** 10
- **Triggers:** 0
- **Slug:** `PILVIO`
- **Version:** 20260211_00

## Tools

### 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `billing_account_id` | string | Yes | Path parameter. The ID of the billing account to list credit cards for. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Invoices

**Slug:** `PILVIO_LIST_INVOICES`

Tool to retrieve a list of invoices. Use after authentication to fetch and filter invoices for a billing account.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | Number of invoices per page. |
| `offset` | integer | No | Pagination offset (zero-based). |
| `status` | string ("paid" | "unpaid" | "pending") | No | Filter invoices by status. |
| `date_to` | string | No | ISO 8601 timestamp (inclusive) to filter invoices created on or before this date. |
| `date_from` | string | No | ISO 8601 timestamp (inclusive) to filter invoices created on or after this date. |
| `billing_account_id` | string | Yes | Billing account ID to retrieve invoices for. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List VM Resource Pools

**Slug:** `PILVIO_LIST_VM_RESOURCE_POOLS`

Tool to retrieve the list of available VM resource pools. Use after authentication to determine where you can provision VMs.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | integer | No | Page number for pagination (1-based) |
| `page_size` | integer | No | Number of items per page |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Virtual Machines

**Slug:** `PILVIO_LIST_VMS`

Tool to retrieve a list of all virtual machines. Use after authenticating to fetch your VMs.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `sort` | string | No | Sort by field |
| `limit` | integer | No | Maximum results per page |
| `offset` | integer | No | Pagination offset |
| `project_id` | string | No | Filter by project id |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List VM Snapshots

**Slug:** `PILVIO_LIST_VM_SNAPSHOTS`

Tool to list snapshots (replicas) of a specific VM. Use this to get all point-in-time snapshots or backups for a virtual machine.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `uuid` | string | Yes | UUID of the VM to fetch replicas/snapshots for |
| `r_type` | string | No | Type of replica to list: 'snapshot' or 'backup'. Defaults to 'snapshot' |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `email` | string | No | User's email address |
| `username` | string | Yes | User's username (required for identification) |
| `last_name` | string | No | User's last name |
| `first_name` | string | No | User's first name |
| `phone_number` | string | No | User's phone number |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |