Pilvio integration: operations for AI agents
Pilvio connects to Type.com as an integration. This page lists the 108 operations documented for Claude and Codex in Type.com: 38 read, 50 write, 20 destructive.
About Pilvio
Pilvio is a cloud service provider offering virtual machines, object storage, and full API support for resource management and automation.
Categories: Developer Tools & IT
How to connect Pilvio to Type.com
- Access
- Organization connection: one shared account for the workspace.
To add the connection, follow the steps in Space connections.
Documented operations
108 operations. Your connection's permissions determine which operations are available. API references describe the vendor surface; they do not expand your connection's credentials or access.
108 operations listed.
- Read
Get User Info
Authenticated user can request data-model for themselves
GET /v1/user-resource/user - Read
List SSH Keys
List all SSH public keys associated with the authenticated user.
GET /v1/user-resource/ssh_keys - Read
List Tokens
List user API tokens
GET /v1/user-resource/token/list - Read
List Locations
Locations are different data centres or resource pools where virtual machines can be hosted. By default API calls manage resources in the "is_default": true location. To access a specific location, its slug must be used in the API URL right after version number: v1/{slug}/ . In the following example Cycletown location is used if no location is specified. To get a full list of all location-specific resources, all locations must be queried. There is no API endpoint that would return virtual machines from all locations.
GET /v1/config/locations - Read
Get VM Info
Get virtual machine data This is a location-specific request; select the documented resource location.
GET /v1/user-resource/vm - Read
List VM resource pools
Get a list of pools available for running compute resources. This is a location-specific request; select the documented resource location.
GET /v1/user-resource/host_pool/list - Read
List VMs
Get virtual machine list This is a location-specific request; select the documented resource location.
GET /v1/user-resource/vm/list - Read
List Replicas
Get virtual machine storage replica list This is a location-specific request; select the documented resource location.
GET /v1/user-resource/vm/replica - Read
Get Disk
Get one disk. This is a location-specific request; select the documented resource location.
GET /v1/storage/disks/{disk_uuid} - Read
List Disks
List user's disks. This is a location-specific request; select the documented resource location.
GET /v1/storage/disks - Read
S3 API Info
Returns S3 API URL.
GET /v1/storage/api/s3 - Read
Get Bucket
Get bucket information.
GET /v1/storage/bucket - Read
List Buckets
List user's buckets. Optionally filter the list by billing account.
GET /v1/storage/bucket/list - Read
Get keys
Returns all user keys.
GET /v1/storage/user/keys - Read
Get network data
Get network data This is a location-specific request; select the documented resource location.
GET /v1/network/network/{network_uuid} - Read
List Networks
List user networks with resources. This is a location-specific request; select the documented resource location.
GET /v1/network/networks - Read
List Floating IPs
List floating IPs. Can be filtered by billing_account_id and vm_uuid , if necessary. This is a location-specific request; select the documented resource location.
GET /v1/network/ip_addresses - Read
Get Floating IP
Get floating IP This is a location-specific request; select the documented resource location.
GET /v1/network/ip_addresses/{public_ipv4_address} - Read
List Firewalls
Retrieves a list of firewalls for the current user. This is a location-specific request; select the documented resource location.
GET /v1/network/firewalls - Read
List user load balancers
Get list of load balancers owned by user. This is a location-specific request; select the documented resource location.
GET /v1/network/load_balancers - Read
Get user load balancer by UUID
Get user load balancer by UUID. This is a location-specific request; select the documented resource location.
GET /v1/network/load_balancers/{load_balancer_uuid} - Read
VM parameters
Describes VM creation parameters and their expected and allowed values.
GET /v1/api/parameters/vm - Read
VM images list
Returns list of VM images and corresponding versions for the platform Compute section.
GET /v1/config/vm_images - Read
Get Plain OS images
Returns list of plain Virtual Machines images and corresponding versions for the platform Compute section.
GET /v1/config/vm_images/plain_os - Read
Get App Catalog images
Returns list of App Catalog images and corresponding versions for the platform Compute section.
GET /v1/config/vm_images/app_catalog - Read
List bootable media images
The above command returns a JSON array with elements like this: Returns list of available bootable ISO images.
GET /v1/config/boot_images - Read
List Billing Account's Resources
Get all resources actively associated with billing account This is a location-specific request; select the documented resource location.
GET /v1/user-resource/billing_resources - Read
Billing account details
Get billing account's detailed data.
GET /v1/payment/billing_account - Read
List billing accounts
List billing accounts attached to user. Additionally 'show_shadow' attribute may be added (any value) to get also deleted accounts
GET /v1/payment/billing_account/list - Read
Get unpaid amount
Get billing account's unpaid total amount (with VAT included). This is unpaid amount of all invoices who's status is not 'paid'.
GET /v1/payment/billing_account/unpaid_amount - Read
Credit card details
Get payment method details.
GET /v1/payment/card - Read
List credit cards
Get list of credit cards attached to billing account.
GET /v1/payment/card/list - Read
List credit
Show data about billing account's credit amount and individual records.
GET /v1/payment/credit/list - Read
Invoice details
Get invoice details.
GET /v1/payment/invoice - Read
List invoices
List billing account's invoices.
GET /v1/payment/invoice/list - Read
Active campaigns status
Check if there are any active campaigns
GET /v1/payment/has_active_campaigns - Read
Pricing policy
Policy that describes how resources are priced.
GET /v1/pricing/policy - Read
Get Resource Usage
Resources, prices and costs for the specified billing account, for the current month.
GET /v1/charging/usage - Write
Modify Profile Info
Authenticated user can modify their own profile data
PATCH /v1/user-resource/user/profile - Write
Create SSH Key
Create a new SSH public key. The public_key is immutable once created. Notes
POST /v1/user-resource/ssh_keys - Write
Update SSH Key Name
Rename an existing SSH key. Only metadata (name) can be changed.
PATCH /v1/user-resource/ssh_keys/{uuid} - Write
Update Token
Update API token options.
PATCH /v1/user-resource/token - Write
Create Token
Create new token and register it at API Gateway
POST /v1/user-resource/token - Write
Change Password
Set a new password for an existing user on the virtual machine. The VM must be running, otherwise the password cannot be changed and an error will be returned. This is a location-specific request; select the documented resource location.
PATCH /v1/user-resource/vm/user - Write
Modify VM
Currently only name, vcpu and ram can be changed. Do note that vcpu and ram can only be changed when the machine is in stopped state. This is a location-specific request; select the documented resource location.
PATCH /v1/user-resource/vm - Write
Create VM
Create a new virtual machine. billing_account_id is optional if using an API token that is restricted to one billing account. Specify source_uuid (VM UUID) and source_replica (snapshot or backup UUID) to create the new virtual machine as a copy of an existing backup or snapshot. Specify disk_uuid to use an existing unattached disk as the boot disk for the new VM. In this case disks parameter has no effect and should be left empty. If a VM without public IPv4 address is needed, set reserve_public_ip to False . Specify network_uuid to create the VM in the given network. If the value is emtpy the VM is created in the default network. To create a VM with an empty disk, use the special values os_name=_custom and os_version=_ , or alternatively omit the parameters os_name and os_version . The VM can then be booted from a custom installation ISO to install an OS, see Boot a rescue or installation media for more information. VMs are initialized using cloud-init . You can provide custom user-data via the cloud_init parameter, a valid YAML or JSON object is expected. Any keys you provide will override the platform provided values. Setting users here will overwrite username and password parameters. For a full list of capabilities, please refer to the official cloud-init documentation. The designated_pool_uuid parameter allows to choose a server class that the VM will be hosted on. See also List VM resource pools This is a location-specific request; select the documented resource location.
POST /v1/user-resource/vm - Write
Toggle Auto Backup
Toggle automatic backups for virtual machine This is a location-specific request; select the documented resource location.
POST /v1/user-resource/vm/backup - Write
Clone VM
Clone existing virtual machine This is a location-specific request; select the documented resource location.
POST /v1/user-resource/vm/clone - Write
Reserve Public IP
DEPRECATED, see Floating IP for the updated API. This endpoint reserves a new IP address but does not return it in the response. Reserve and assign a public IP address for a virtual machine. This is a location-specific request; select the documented resource location.
POST /v1/user-resource/vm/ip/public - Write
Create Replica
Create replica from block storage This is a location-specific request; select the documented resource location.
POST /v1/user-resource/vm/replica - Write
Start VM
Start virtual machine This is a location-specific request; select the documented resource location.
POST /v1/user-resource/vm/start - Write
Boot a rescue or installation media
Launches the VM with a "live" OS image attached as a cd-rom device and used for booting. The mode is enabled for a single launch only: next time this VM is started, it will follow a normal routine. A custom bootable media can be used for booting the VM by passing "private" as the boot_image_repository parameter. In that case, the boot_image_uuid must refer to a disk that has read_only_bootable attribute set as true . The disk is expected to contain a bootable ISO 9660 file system. See also: List bootable media images , List disks This is a location-specific request; select the documented resource location.
POST /v1/user-resource/vm/boot_iso_media - Write
Add Disk
Create and add a disk device of specified capacity to a virtual machine. This is a location-specific request; select the documented resource location.
POST /v1/user-resource/vm/storage - Write
Modify Disk
Modify virtual machine disk with the specified capacity. New disk size cannot be smaller than current size. This is a location-specific request; select the documented resource location.
PATCH /v1/user-resource/vm/storage - Write
Create Disk
Creates a new block storage aka disk. It can be initiated as an empty disk, or it can be a copy of an OS base image, an existing disk or a snapshot. If source_image is set then the new image will be a copy of the image referred here. source_image is required if source_image_type is something else than EMPTY . For OS_BASE it must be something like ubuntu_20.04 . For DISK or SNAPSHOT it is the UUID of the respective resource. If the OS supports it, a device ID will be constructed from new disk UUID and assigned on OS level, in the same way as described in Attach Disk call This is a location-specific request; select the documented resource location.
POST /v1/storage/disks - Write
Modify Disk Info
Modify meta-data of a disk. See list of attributes that can be modified below. This is a location-specific request; select the documented resource location.
PATCH /v1/storage/disks/{disk_uuid} - Write
Attach Disk
Attaches a disk to a virtual machine. If the OS supports assigning a device ID from a specified serial number, the OS disk identifier will be based on first 20 symbols of the disk UUID, with an additional virtio- prefix. For example: /dev/disk/by-id/virtio-3d91aa31-16ec-44ee-b This is a location-specific request; select the documented resource location.
POST /v1/user-resource/vm/storage/attach - Write
Detach Disk
Detaches a disk from a virtual machine. This is a location-specific request; select the documented resource location.
POST /v1/user-resource/vm/storage/detach - Write
Create Bucket
Create an S3 object storage bucket. Bucket names must be globally unique across all users.
PUT /v1/storage/bucket - Write
Modify Bucket
Modify a bucket's billing account.
PATCH /v1/storage/bucket - Write
Generate key
Generate a new S3 key pair. Returns the list of all keys.
POST /v1/storage/user/keys - Write
Create a private network
Creates a new private network with specified descriptive name. If the created network is the first network of the user, it is set as default. This is a location-specific request; select the documented resource location.
POST /v1/network/network - Write
Change network to default
Change network to default. The network is change to the default network for the future resources. The other private networks will be changed to non default. This is a location-specific request; select the documented resource location.
PUT /v1/network/network/{network_uuid}/default - Write
Change network name
Change network name. This is a location-specific request; select the documented resource location.
PATCH /v1/network/network/{network_uuid} - Write
Create Floating IP
Create new floating IP This is a location-specific request; select the documented resource location.
POST /v1/network/ip_addresses/ - Write
Update Floating IP
Update floating IP This is a location-specific request; select the documented resource location.
PATCH /v1/network/ip_addresses/{public_ipv4_address} - Write
Assign Floating IP
Assign floating IP. Accepted values of assigned_to_resource_type : "virtual_machine" "service" "load_balancer" This is a location-specific request; select the documented resource location.
POST /v1/network/ip_addresses/{public_ipv4_address}/assign - Write
Un-assign Floating IP
Un-assign floating IP This is a location-specific request; select the documented resource location.
POST /v1/network/ip_addresses/{public_ipv4_address}/unassign - Write
Create Firewall
Creates a new firewall with a given set of rules. See also Representation & validation This is a location-specific request; select the documented resource location.
POST /v1/network/firewalls - Write
Update Firewall
Updates an existing firewall configuration. This is a location-specific request; select the documented resource location.
PUT /v1/network/firewalls/{firewallUuid} - Write
Assign Firewall to VM
Associates a firewall with a specific virtual machine. This is a location-specific request; select the documented resource location.
POST /v1/network/firewalls/{firewallUuid}/vms - Write
Create load balancer
Create new load balancer This is a location-specific request; select the documented resource location.
POST /v1/network/load_balancers - Write
Rename load balancer
Rename load balancer This is a location-specific request; select the documented resource location.
PATCH /v1/network/load_balancers/{load_balancer_uuid} - Write
Add load balancer target
Add new target to load balancer This is a location-specific request; select the documented resource location.
POST /v1/network/load_balancers/{load_balancer_uuid}/targets - Write
Add load balancer forwarding rule
Add new port forwarding rule to load balancer This is a location-specific request; select the documented resource location.
POST /v1/network/load_balancers/{load_balancer_uuid}/forwarding_rules - Write
Change billing account on load balancer
Change Billing Account that load balancer is assigned to. This is a location-specific request; select the documented resource location.
PUT /v1/network/load_balancers/{load_balancer_uuid}/billing_account - Write
Set Resource Billing Conf
Associate resource with billing account This is a location-specific request; select the documented resource location.
POST /v1/user-resource/resource_billing - Write
Update billing account
Update billing account's data. All existing data fields that billing account already has, must be passed along also. Otherwise this data will be deleted (PS! e-mail field can't be deleted). Exception is recurring payment conf, this is handled by another endpoint.
PUT /v1/payment/billing_account - Write
Configure recurring payment
Configuring recurring payment for a billing account. Account needs to have a payment method that is capable of automated payments (e.g. credit card). When billing account running_totals.ongoing value goes below recurring_payment_threshold then an automatic top up for recurring_payment_amount is made with billing account's default payment method. It might happen that after configuration change ongoing is already below threshold, in that case payment is done immediately. In this case payment_report.triggered=true in the response.
PUT /v1/payment/billing_account/{billing_account_id}/recurring_payment - Write
Set default billing account
Set billing account as default account.
POST /v1/payment/billing_account/set_default - Write
Apply for invoice paying
The above command returns newly created payment object data in JSON structured like this: Apply for 'paying by invoice' payment method. Billing account will then have a new payment object that uses 'invoice' payment method. Method will be in unverified state until admin verifies it.
POST /v1/payment/apply_for_invoice_payment - Write
Add credit card
Add new credit card. Possible to add primary and secodary (failover) card. Steps involved when add a new card: - attach payment object to the billing account (credit card) - check payment object validity
POST /v1/payment/card - Write
Set card as primary
Set credit card specified by id as 'primary'. Throws exception if specified card is not validated. Unmarks previous 'primary' card.
PUT /v1/payment/card/set_primary - Write
Buy credit
Buy credit for a billing account, using specified credit card.
POST /v1/payment/credit/buy - Write
Request invoice for credit top up
Request invoice for credit top up using manual bank transfer. Invoice will be generated with specified amount and sent to billing account's e-mail address.
POST /v1/payment/credit/request_invoice - Write
Pay all
Pay all billing account's unpaid invoices. Pays oldest invoices first.
POST /v1/payment/pay_all - Write
Pay amount
Pay the amount specified with parameters. Pays billing account's oldest unpaid invoices first.
POST /v1/payment/pay_amount - Write
Pay invoice
Pay invoice specified by id.
POST /v1/payment/pay_invoice - Destructive
Delete SSH Key
Delete an SSH key by UUID. Notes
DELETE /v1/user-resource/ssh_keys/{uuid} - Destructive
Delete Token
Delete API token
DELETE /v1/user-resource/token - Destructive
Delete VM
Delete virtual machine This is a location-specific request; select the documented resource location.
DELETE /v1/user-resource/vm - Destructive
Reinstall VM
Discard virtual machine's current storage state and overwrite it with an OS base image. os_name and os_version are optional, the default is to reinstall the same OS version that the VM currently has. This is a location-specific request; select the documented resource location.
POST /v1/user-resource/vm/reinstall - Destructive
Release Public IP
DEPRECATED, see Floating IP for the updated API. Release a virtual machine's public IPv4 address. The address will remain reserved for the user. This is a location-specific request; select the documented resource location.
DELETE /v1/user-resource/vm/ip/public - Destructive
Rebuild from Replica
Discard virtual machine's current storage state and restore it from the specified replica. This is a location-specific request; select the documented resource location.
POST /v1/user-resource/vm/rebuild - Destructive
Delete Replica
Delete replica by uuid This is a location-specific request; select the documented resource location.
DELETE /v1/user-resource/vm/replica - Destructive
Stop VM
Stop a virtual machine. By default, tries to stop the VM gracefully via ACPI shutdown signal, this gives the OS the opportunity to do a proper shutdown. If, for some reason, the OS does not respond to a normal shutdown signal, an optional force=True parameter can be specified. This will "pull the plug" immediately, it is the physical equivalent of cutting the power supply to a machine. This has the potential danger of leaving behind corrupt data on the VM, so use it with caution. This is a location-specific request; select the documented resource location.
POST /v1/user-resource/vm/stop - Destructive
Delete Attached Disk
Disconnects and completely removes a disk device from a virtual machine. Data on that disk will be irrecoverably lost. Primary/boot disks cannot be deleted. Both VM UUID and disk UUID must be provided. This is a location-specific request; select the documented resource location.
DELETE /v1/user-resource/vm/storage - Destructive
Delete Disk
The above command returns HTTP status 204 No Content Delete a disk and all its snapshots. All its data will be lost irrecoverably. This is a location-specific request; select the documented resource location.
DELETE /v1/storage/disks/{disk_uuid} - Destructive
Delete Bucket
The above command returns HTTP status 204 No Content Delete an S3 object storage bucket. Only empty buckets can be deleted via this API.
DELETE /v1/storage/bucket - Destructive
Delete key
Delete an S3 key.
DELETE /v1/storage/user/keys - Destructive
Delete network
The above command returns an empty response Delete network. The network can be deleted if it does not contain any resources and it is not default. This is a location-specific request; select the documented resource location.
DELETE /v1/network/network/{network_uuid} - Destructive
Delete Floating IP
The above command returns like this: Delete floating IP This is a location-specific request; select the documented resource location.
DELETE /v1/network/ip_addresses/{public_ipv4_address} - Destructive
Delete Firewall
Deletes a specified firewall. This is a location-specific request; select the documented resource location.
DELETE /v1/network/firewalls/{firewallUuid} - Destructive
Delete load balancer
Delete load balancer This is a location-specific request; select the documented resource location.
DELETE /v1/network/load_balancers/{load_balancer_uuid} - Destructive
Unlink load balancer target
Unlink target from load balancer This is a location-specific request; select the documented resource location.
DELETE /v1/network/load_balancers/{load_balancer_uuid}/targets/{target_or_rule_uuid} - Destructive
Drop load balancer rule
Drop port rule from load balancer This is a location-specific request; select the documented resource location.
DELETE /v1/network/load_balancers/{load_balancer_uuid}/forwarding_rules/{target_or_rule_uuid} - Destructive
Delete billing account
Delete a billing account.
DELETE /v1/payment/billing_account - Destructive
Remove credit card
Remove credit card.
DELETE /v1/payment/card
No operations match.
See How connections work for access and permissions, or browse all integrations.