NagentArtefacts
Dev & Technology
Enterprise and White Glove
Company
Pilvio connects to a Nagent workspace with an API key. Once it is connected, agents can call 10 Pilvio actions, such as "Get User Info", "List billing accounts" and "List Credit Cards". Nothing is enabled on connect: each action is allowed one at a time, and an action with side effects runs or waits for a person according to the agent's level.
Every operation an agent can call against Pilvio, with input parameters and output schema.
PILVIO_CHECK_ACTIVE_CAMPAIGNSTool to check for active campaigns. Use when you need to verify whether any campaigns are currently active.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
PILVIO_GET_USER_INFOTool to retrieve information about the authenticated user. Use when you need to fetch the current user's profile after authentication.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
PILVIO_LIST_BILLING_ACCOUNTSTool 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 from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
PILVIO_LIST_CREDIT_CARDSTool 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
Path parameter. The ID of the billing account to list credit cards for.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
PILVIO_LIST_INVOICESTool to retrieve a list of invoices. Use after authentication to fetch and filter invoices for a billing account.
Input parameters
Number of invoices per page.
Pagination offset (zero-based).
Filter invoices by status.
ISO 8601 timestamp (inclusive) to filter invoices created on or before this date.
ISO 8601 timestamp (inclusive) to filter invoices created on or after this date.
Billing account ID to retrieve invoices for.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
PILVIO_LIST_LOCATIONSTool to retrieve the list of available data center locations. Use after authentication to see where you can deploy resources.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
PILVIO_LIST_VM_RESOURCE_POOLSTool to retrieve the list of available VM resource pools. Use after authentication to determine where you can provision VMs.
Input parameters
Page number for pagination (1-based)
Number of items per page
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
PILVIO_LIST_VMSTool to retrieve a list of all virtual machines. Use after authenticating to fetch your VMs.
Input parameters
Sort by field
Maximum results per page
Pagination offset
Filter by project id
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
PILVIO_LIST_VM_SNAPSHOTSTool 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
UUID of the VM to fetch replicas/snapshots for
Type of replica to list: 'snapshot' or 'backup'. Defaults to 'snapshot'
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
PILVIO_UPDATE_USER_PROFILETool 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
User's email address
User's username (required for identification)
User's last name
User's first name
User's phone number
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
Agents can call 10 Pilvio actions on Nagent, including "Get User Info", "List billing accounts" and "List Credit Cards". Get User Info: Retrieve information about the authenticated user. Each action is listed on this page with its input parameters and its output.
Pilvio connects with an API key, under your workspace's own connection. Nothing is enabled on connect: each action is allowed one at a time and can be scoped to the agents that need it.
It returns data, error and successful.