Skip to content
Changelog

Report a bug

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

See How connections work for access and permissions, or browse all integrations.