---
canonical_url: "https://docs.composio.dev/toolkits/cloud_66"
markdown_url: "https://docs.composio.dev/toolkits/cloud_66.md"
product: "platform"
version: null
last_updated: null
---

# Cloud 66

Deploy and manage applications, stacks, servers, databases, networking, and users across cloud providers with Cloud 66.

- **Category:** it operations
- **Auth:** OAUTH2
- **Composio-managed OAuth available?** No
- **Tools:** 102
- **Triggers:** 0
- **Slug:** `CLOUD_66`
- **Version:** 00000000_00

## Tools

### Add User Device

**Slug:** `CLOUD_66_ADD_USER_DEVICE`

Register a human user's mobile device token with Cloud 66. This changes the user's UI notification destination. Cloud 66 currently supports iOS devices; Android is documented but not currently available.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | integer | Yes | The Cloud 66 user ID. |
| `token` | string | Yes | Sensitive mobile device token to register for this user. This connects a human UI device to the user's Cloud 66 account. |
| `sub_type` | integer ("1" | "2" | "3") | Yes | Apple device subtype: 1 for iPhone, 2 for iPad, or 3 for iPod. |
| `device_type` | integer ("1" | "2") | Yes | Device platform: 1 for iOS or 2 for Android. Cloud 66 documents Android but notes that Android support is not currently available. |

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

### Cancel Deployment

**Slug:** `CLOUD_66_CANCEL_DEPLOYMENT`

Cancel an existing Cloud 66 deployment. This irreversibly stops the deployment operation but does not delete its deployment history.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `stack_id` | string | Yes | UID of the stack that owns the deployment. |
| `deployment_id` | integer | Yes | ID of the deployment to cancel. |

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

### Clear Stack Caches

**Slug:** `CLOUD_66_CLEAR_STACK_CACHES`

Clear all application caches for a Cloud 66 stack and return the accepted asynchronous job by default. Cache removal cannot be undone.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `stack_id` | string | Yes | Unique identifier of the stack on which to run the action. |
| `timeout_seconds` | number | No | Maximum seconds to wait within the tool execution window. |
| `wait_for_completion` | boolean | No | Return after Cloud 66 accepts the asynchronous job by default. Set true to poll within the bounded tool execution window. |
| `poll_interval_seconds` | number | No | Seconds between action-status checks when waiting. |

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

### Commit Application Variant

**Slug:** `CLOUD_66_COMMIT_APPLICATION_VARIANT`

Finalize a rollout application variant and make it the active production version. This immediately changes which application version serves production traffic and cannot be undone by this action.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | UID of the rollout application variant to commit. |
| `stack_id` | string | Yes | UID of the stack that owns the rollout application variant. |

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

### Create Backup Task

**Slug:** `CLOUD_66_CREATE_BACKUP_TASK`

Create a scheduled backup task for a Cloud 66 stack. Cloud 66 only acknowledges that the task was queued; this action does not wait for or claim backup completion.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `gzip` | boolean | No | Whether to compress backups with gzip. |
| `db_type` | string | No | Comma-separated database types that need backup tasks. Valid values are all, mysql, postgresql, redis, and mongodb. |
| `stack_id` | string | Yes | UID of the stack that owns the backup task. |
| `frequency` | string | No | Backup task frequency in cron schedule format. |
| `keep_count` | integer | No | Number of previous backups to keep. |
| `excluded_tables` | string | No | Tables to exclude from the backup. |
| `run_on_replica_server` | boolean | No | Whether to run the backup task on a replica server when available. |

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

### Create Cluster

**Slug:** `CLOUD_66_CREATE_CLUSTER`

Call Cloud 66's documented cluster-creation route with no parameters. Cloud 66 currently documents this operation as unavailable and returning HTTP 501 Not Implemented; this action reports that condition as an error, not success.

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

### Create Container Session

**Slug:** `CLOUD_66_CREATE_CONTAINER_SESSION`

Start an interactive Cloud 66 container session. A successful result confirms only that the asynchronous action was accepted; it does not confirm that the session is ready.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `stack_id` | string | Yes | UID of the container-based stack that owns the service. |
| `service_name` | string | Yes | Name of the service in the stack's active rollout variant. |

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

### Create Database

**Slug:** `CLOUD_66_CREATE_DATABASE`

Create a database in a Cloud 66 server group, optionally grant database users access, and by default wait for asynchronous completion.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `stack_id` | string | Yes | UID of the stack that will own the database. |
| `database_name` | string | Yes | Name for the new database. |
| `server_group_id` | integer | Yes | Numeric ID of the server group in which to create the database. |
| `timeout_seconds` | number | No | Maximum total seconds to wait for a terminal action state. |
| `database_user_ids` | array | No | Database user UIDs to grant access to the new database. |
| `wait_for_completion` | boolean | No | Wait for the asynchronous database creation to finish before returning. |
| `poll_interval_seconds` | number | No | Seconds between action-status checks when waiting. |

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

### Create Database User

**Slug:** `CLOUD_66_CREATE_DATABASE_USER`

Create a database user in a Cloud 66 server group. By default, wait for the asynchronous action to finish and return only after Cloud 66 reports successful completion.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `stack_id` | string | Yes | UID of the stack that owns the database server group. |
| `username` | string | Yes | Database username to create. |
| `user_type` | string | Yes | Database-user type supported by the target server group. Cloud 66 does not publish an exhaustive value list; discover a compatible value from existing users with CLOUD_66_LIST_DATABASE_USERS or the Cloud 66 UI. |
| `database_ids` | array | No | Database UIDs to which the new user should have access. |
| `server_group_id` | integer | Yes | ID of the server group in which to create the database user. |
| `timeout_seconds` | number | No | Maximum total seconds to wait for a terminal action state. |
| `wait_for_completion` | boolean | No | Wait for the asynchronous create action to finish before returning. |
| `poll_interval_seconds` | number | No | Seconds between action-status checks when waiting. |

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

### Create Elastic Address

**Slug:** `CLOUD_66_CREATE_ELASTIC_ADDRESS`

Create an elastic address failover group between distinct primary and secondary Cloud 66 stacks.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `current_stack` | string ("primary" | "secondary") | No | Stack that should initially receive traffic in the failover group. |
| `primary_stack_uid` | string | Yes | UID of the primary stack in the failover group. |
| `secondary_stack_uid` | string | Yes | UID of the secondary stack in the failover group. |

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

### Create Firewall Rule

**Slug:** `CLOUD_66_CREATE_FIREWALL_RULE`

Add a firewall rule to a Cloud 66 stack using a numeric protocol code and at least one destination field. Returns the accepted asynchronous action; the action ID is not the created firewall-rule ID.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `port` | integer | Yes | Network port from 0 through 65535 for the selected protocol code. |
| `to_ip` | string | No | Destination IPv4 or IPv6 address or CIDR. Provide at least one destination field. |
| `from_ip` | string | No | Optional source IPv4 or IPv6 address or CIDR range allowed by the rule. |
| `protocol` | integer | Yes | Cloud 66 numeric protocol code. Live API verification established 1 for TCP; use another code only when confirmed for the connected account. |
| `stack_id` | string | Yes | UID of the stack that will receive the firewall rule. |
| `to_group_id` | integer | No | Destination server-group ID. Provide at least one destination field. |
| `to_server_id` | string | No | Cloud 66's internal server ID, not the server UID returned by server list/get actions. Unrecognized values may be silently ignored; prefer to_group_id or to_ip when the internal ID is unavailable. |

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

### Create Gateway

**Slug:** `CLOUD_66_CREATE_GATEWAY`

Create a gateway for a Cloud 66 account using bastion-server connection metadata without accepting private-key content. Cloud 66 confirms success without returning the new gateway ID; call CLOUD_66_LIST_GATEWAYS afterward.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `ttl` | integer | No | Number of seconds the gateway should remain available. |
| `name` | string | Yes | Name for the new gateway. |
| `address` | string | No | Public IP address or DNS name of the bastion server. |
| `username` | string | No | Username for the bastion server. |
| `account_id` | string | Yes | ID of the Cloud 66 account that will own the gateway. |
| `private_ip` | string | No | Private IP address or DNS name of the bastion server. |

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

### Create SSL Certificate

**Slug:** `CLOUD_66_CREATE_SSL_CERTIFICATE`

Submit a Let's Encrypt SSL-certificate creation request for a Cloud 66 stack. Manual certificate and private-key uploads are excluded. A successful result confirms request acceptance only, not completed certificate provisioning.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `type` | string | Yes | Automatic Let's Encrypt provisioning; manual private-key uploads are excluded. |
| `stack_id` | string | Yes | Unique identifier of the stack that will own the SSL certificate. |
| `wildcard` | boolean | Yes | Whether Cloud 66 should create a wildcard certificate; required by the create endpoint. |
| `server_names` | string | Yes | Comma-separated domain names covered by the certificate. |
| `ssl_termination` | boolean | Yes | Whether Cloud 66 terminates SSL on the load balancer. |
| `dns_provider_uuid` | string | No | DNS provider UUID required for a wildcard Let's Encrypt certificate. |

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

### Create Stack

**Slug:** `CLOUD_66_CREATE_STACK`

Create and build a Docker stack. A non-terminal result confirms acceptance only because Cloud 66 does not return a documented stack UID that can safely route action-status polling.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `name` | string | Yes | Name for the new stack. |
| `size` | string | No | Cloud server size to use when no manifest is supplied. |
| `cloud` | string | No | Cloud provider in which to create servers when no manifest is supplied. |
| `region` | string | No | Cloud region in which to create servers when no manifest is supplied. |
| `key_name` | string | No | Cloud provider key name. When omitted, Cloud 66 uses the default or first available key for the selected cloud. |
| `build_type` | string ("single" | "multi") | No | Whether to deploy all services to a single server or multiple servers. |
| `environment` | string | Yes | Environment for the new stack. |
| `service_yaml` | string | Yes | Serialized services definition for the new Docker stack. |
| `manifest_yaml` | string | No | Serialized manifest definition. Provide this instead of cloud, key_name, region, size, and build_type. |

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

### Delete All Tags

**Slug:** `CLOUD_66_DELETE_ALL_TAGS`

Permanently delete all tags from one Cloud 66 server or load balancer. This removes the entity's entire tag set, not one selected tag, and cannot be undone; verify the entity type and ID first.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `entity_id` | string | Yes | ID of the server or load balancer whose entire tag set will be permanently deleted. Verify the entity before deletion. |
| `entity_type` | string ("server" | "loadbalancer") | Yes | Type of entity whose tags will all be permanently deleted. Cloud 66 supports 'server' and 'loadbalancer'. Verify the type before deletion. |

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

### Delete Application Variant

**Slug:** `CLOUD_66_DELETE_APPLICATION_VARIANT`

Permanently delete a preview application variant from a Cloud 66 stack. This operation only applies to preview variants and cannot be undone.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | UID of the preview application variant to permanently delete. |
| `stack_id` | string | Yes | UID of the stack that owns the preview variant. |

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

### Delete Database

**Slug:** `CLOUD_66_DELETE_DATABASE`

Permanently delete a Cloud 66 database and all of its data. This cannot be undone. By default, wait for the asynchronous action to finish and fail unless Cloud 66 confirms successful completion.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | UID of the database to permanently delete with all of its data. |
| `stack_id` | string | Yes | UID of the stack that owns the database. |
| `server_group_id` | integer | Yes | ID of the server group that owns the database. |
| `timeout_seconds` | number | No | Maximum total seconds to wait for a terminal deletion state. |
| `wait_for_completion` | boolean | No | Wait for the asynchronous database deletion to finish before returning. |
| `poll_interval_seconds` | number | No | Seconds between action-status checks when waiting. |

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

### Delete Database User

**Slug:** `CLOUD_66_DELETE_DATABASE_USER`

Permanently remove a database user from every associated database. This cannot be undone. By default, wait for Cloud 66's asynchronous deletion to finish and fail if the terminal action reports failure.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | UID of the database user to permanently delete. |
| `stack_id` | string | Yes | UID of the stack that owns the database server group. |
| `server_group_id` | integer | Yes | ID of the server group that owns the database user. |
| `timeout_seconds` | number | No | Maximum total seconds to wait for a terminal action state. |
| `wait_for_completion` | boolean | No | Wait for the asynchronous deletion action to finish before returning. |
| `poll_interval_seconds` | number | No | Seconds between action-status checks when waiting. |

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

### Delete Elastic Address

**Slug:** `CLOUD_66_DELETE_ELASTIC_ADDRESS`

Permanently delete a Cloud 66 elastic address (failover group). This cannot be undone. The failover group must be detached from all stacks before deletion.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `uid` | string | Yes | UID of the elastic address (failover group) to permanently delete. It must first be detached from every stack. |

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

### Delete Environment Variable

**Slug:** `CLOUD_66_DELETE_ENVIRONMENT_VARIABLE`

Permanently delete an environment variable from a Cloud 66 stack by its key/name. This irreversible operation cannot recover the deleted value; verify the stack UID and key before calling it.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `stack_id` | string | Yes | UID of the stack containing the environment variable. Verify this UID before deletion because the operation cannot be undone. |
| `env_var_key` | string | Yes | Exact environment variable key/name to permanently delete, not its numeric ID. Verify the key because this operation cannot recover its value. |

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

### Delete Gateway

**Slug:** `CLOUD_66_DELETE_GATEWAY`

Permanently delete a gateway from a Cloud 66 account. This irreversible operation cannot be undone; verify both the account ID and gateway ID first.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | integer | Yes | Numeric ID of the gateway to permanently delete. Verify the gateway before deleting because this operation cannot be undone. |
| `account_id` | string | Yes | ID of the Cloud 66 account that owns the gateway. Verify the account before deleting because this operation cannot be undone. |

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

### Delete SSL Certificate

**Slug:** `CLOUD_66_DELETE_SSL_CERTIFICATE`

Permanently delete an SSL certificate from a Cloud 66 stack. Verify the stack and certificate identifiers before this irreversible operation. A successful result confirms request acceptance only, not completed removal.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `stack_id` | string | Yes | Unique identifier of the stack. |
| `ssl_certificate_id` | string | Yes | Unique identifier of the SSL certificate to permanently delete. |

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

### Disable Database Replication

**Slug:** `CLOUD_66_DISABLE_DATABASE_REPLICATION`

Disable replication to a Cloud 66 slave database server and return the accepted irreversible asynchronous job by default.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `db_type` | string ("postgresql" | "redis" | "mysql") | No | Database type of the slave server. |
| `stack_id` | string | Yes | Unique identifier of the stack on which to run the action. |
| `server_uid` | string | Yes | UID of the slave database server. |
| `timeout_seconds` | number | No | Maximum seconds to wait within the tool execution window. |
| `wait_for_completion` | boolean | No | Return after Cloud 66 accepts the asynchronous job by default. Set true to poll within the bounded tool execution window. |
| `poll_interval_seconds` | number | No | Seconds between action-status checks when waiting. |

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

**Slug:** `CLOUD_66_GET_ACCOUNT`

Retrieve detailed information for a specific Cloud 66 account.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | integer | Yes | The account ID. |
| `include_servers` | boolean | No | Whether to include unmanaged servers. This is available only for the primary account. |

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

**Slug:** `CLOUD_66_GET_API_STATUS`

Call Cloud 66's unauthenticated basic ping endpoint and return its acknowledgement. A successful response confirms only that this endpoint answered; it does not validate the connected OAuth account or guarantee broader API availability.

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

**Slug:** `CLOUD_66_GET_BACKUP`

Get information about a single Cloud 66 backup.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | integer | Yes | Numeric ID of the backup to retrieve. |
| `stack_id` | string | Yes | UID of the stack that owns the backup. |

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

**Slug:** `CLOUD_66_GET_BACKUP_FILE`

Get the public download URL for a Cloud 66 backup file.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | ID of the backup file. |
| `stack_id` | string | Yes | UID of the stack that owns the backup. |
| `backup_id` | integer | Yes | Numeric ID of the backup. |

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

**Slug:** `CLOUD_66_GET_CLOUD`

Get regions and server sizes for one cloud provider available to the connected Cloud 66 account.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `cloud_id` | string | Yes | Cloud provider ID (name) to retrieve. |

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

**Slug:** `CLOUD_66_GET_CLOUD_REFERENCE`

Return Cloud 66 cloud-provider reference data needed to select valid cloud, region, and server-size values. Use cloud and filter to limit the response.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `cloud` | string ("aws" | "azure_rm" | "digitalocean" | "googlecloud" | "hetzner" | "linode" | "ovh" | "vultr") | No | Cloud provider to return; omit to return reference data for all providers. |
| `filter` | string ("clouds" | "clouds_full" | "regions" | "regions_full" | "sizes" | "sizes_full") | No | Reference subset to return; omit for complete size and region data. Use clouds or clouds_full for providers, regions or regions_full for regions, and sizes or sizes_full for server sizes. |

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

**Slug:** `CLOUD_66_GET_CLUSTER`

Return status, health, capacity, and node details for a Kubernetes cluster.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | UID of the Kubernetes cluster to retrieve. |
| `show_log` | boolean | No | Whether to include the cluster log in the response. |

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

**Slug:** `CLOUD_66_GET_CONTAINER`

Get runtime information for a specific container in a Cloud 66 stack.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `stack_id` | string | Yes | UID of the stack that owns the container. |
| `container_id` | string | Yes | UID of the container to retrieve. |

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

**Slug:** `CLOUD_66_GET_CONTAINER_SESSION`

Get a specific Cloud 66 container session by session ID, or the most recent session for a service. Requires SSH key download permission on the stack.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `stack_id` | string | Yes | UID of the container-based stack that owns the session. |
| `session_id` | integer | No | Database ID of a specific session. Provide this or service_name; this field takes precedence when both are provided. |
| `service_name` | string | No | Service whose most recent session should be returned. Provide this or session_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 |

### Get Current Identity

**Slug:** `CLOUD_66_GET_CURRENT_IDENTITY`

Verify the Cloud 66 connection and return the authenticated user and current account identity.

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

**Slug:** `CLOUD_66_GET_DEPLOYMENT`

Get information about a single deployment in a Cloud 66 stack.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `stack_id` | string | Yes | UID of the stack that owns the deployment. |
| `deployment_id` | integer | Yes | Numeric ID of the deployment to retrieve. |

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

**Slug:** `CLOUD_66_GET_ENVIRONMENT_VARIABLE`

Get one environment variable's name and metadata from a Cloud 66 stack by numeric ID. Current and historical values are never returned.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `stack_id` | string | Yes | UID of the stack that owns the environment variable. |
| `env_var_id` | integer | Yes | Numeric ID of the environment variable to retrieve. |

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

**Slug:** `CLOUD_66_GET_FIREWALL_RULE`

Get information about a specific firewall rule in a Cloud 66 stack.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `stack_id` | string | Yes | UID of the stack that owns the firewall rule. |
| `firewall_rule_id` | integer | Yes | Numeric ID of the firewall rule to retrieve. |

#### 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 Nginx Module Reference

**Slug:** `CLOUD_66_GET_NGINX_MODULE_REFERENCE`

Return the Nginx modules supported by Cloud 66 stack configuration.

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

**Slug:** `CLOUD_66_GET_PROCESS`

Gets one page of information about a specific process in a Cloud 66 stack; Cloud 66 normally returns up to 30 items per page.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | Identifier of the process to retrieve. |
| `stack_id` | string | Yes | UID of the stack that owns the process. |
| `next_cursor` | string | No | Opaque continuation cursor returned by the previous call. Omit it for the first page; Cloud 66 normally returns up to 30 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 |

### Get Server

**Slug:** `CLOUD_66_GET_SERVER`

Get information about a single server in a Cloud 66 stack.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `stack_id` | string | Yes | UID of the stack that owns the server. |
| `server_id` | string | Yes | UID of the server to retrieve. |

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

**Slug:** `CLOUD_66_GET_SERVER_SETTING`

Get information about a single setting for a server in a Cloud 66 stack.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | Identifier of the server setting to retrieve. |
| `stack_id` | string | Yes | UID of the stack that owns the server. |
| `server_id` | string | Yes | UID of the server that owns the setting. |

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

**Slug:** `CLOUD_66_GET_SSL_CERTIFICATE`

Get one SSL certificate from a Cloud 66 stack by certificate identifier.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `stack_id` | string | Yes | Unique identifier of the stack. |
| `ssl_certificate_id` | string | Yes | Unique identifier of the SSL certificate to retrieve. |

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

**Slug:** `CLOUD_66_GET_STACK`

Retrieve detailed configuration, deployment status, and health for a Cloud 66 stack.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | Unique Cloud 66 UID of the stack to retrieve. |

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

**Slug:** `CLOUD_66_GET_STACK_ACTION`

Return the current state and result of one asynchronous Cloud 66 stack action.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | integer | Yes | Numeric identifier of the asynchronous action. |
| `stack_id` | string | Yes | UID of the stack that owns the asynchronous action. |

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

**Slug:** `CLOUD_66_GET_STACK_ALERT`

Return the configuration for a named alert on a Cloud 66 stack.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `stack_id` | string | Yes | UID of the stack that owns the alert configuration. |
| `alert_name` | string | Yes | Alert name to retrieve; provide the raw name and it will be URL-encoded as a path segment. |

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

**Slug:** `CLOUD_66_GET_STACK_SETTING`

Get a single setting for a Cloud 66 stack by its setting identifier.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | Identifier of the stack setting to retrieve. |
| `stack_id` | string | Yes | UID of the stack that owns the setting. |

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

**Slug:** `CLOUD_66_GET_USER`

Get detailed information about a Cloud 66 user by user ID.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | integer | Yes | The Cloud 66 user 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 |

### Import Backup

**Slug:** `CLOUD_66_IMPORT_BACKUP`

Queue an external backup import for a Cloud 66 stack. Cloud 66 only acknowledges that the import was queued; this action does not wait for or claim import completion.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `group` | integer | Yes | Backup group ID into which the imported backup must be restored. |
| `db_type` | string | Yes | Comma-separated database types for the imported backup. Valid values are mysql, postgresql, redis, and mongodb. |
| `stack_id` | string | Yes | UID of the stack into which the external backup will be imported. |
| `remote_url` | string | Yes | URL of the external backup file to import. |

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

**Slug:** `CLOUD_66_LIST_ACCOUNTS`

Lists accounts that the current authenticated user can access. Each call returns one page, normally up to 30 items.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `next_cursor` | string | No | Opaque continuation cursor returned by the previous call. Omit it for the first page; Cloud 66 normally returns up to 30 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 Application Variants

**Slug:** `CLOUD_66_LIST_APPLICATION_VARIANTS`

Returns all active, rollout, and preview application variants for a specified Cloud 66 stack.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `stack_id` | string | Yes | UID of the stack whose application variants to list. |

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

**Slug:** `CLOUD_66_LIST_BACKUP_FILES`

Get backup files for a Cloud 66 stack backup. Each call returns one page, normally up to 30 items.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `stack_id` | string | Yes | UID of the stack whose backup files to list. |
| `backup_id` | integer | Yes | ID of the backup whose files to list. |
| `next_cursor` | string | No | Opaque continuation cursor returned by the previous call. Omit it for the first page; Cloud 66 normally returns up to 30 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 Backups

**Slug:** `CLOUD_66_LIST_BACKUPS`

Gets backups for a Cloud 66 stack. Each call returns one page, normally up to 30 items.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `group` | integer | No | Backup group ID to filter by. |
| `db_type` | string ("mysql" | "postgresql" | "redis" | "mongodb") | No | Database type to filter by. |
| `stack_id` | string | Yes | UID of the stack whose backups to list. |
| `next_cursor` | string | No | Opaque continuation cursor returned by the previous call. Omit it for the first page; Cloud 66 normally returns up to 30 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 Clouds

**Slug:** `CLOUD_66_LIST_CLOUDS`

Get cloud providers available to the connected Cloud 66 account, with their regions and server sizes. Each call returns one page, normally up to 30 items.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `next_cursor` | string | No | Opaque continuation cursor returned by the previous call. Omit it for the first page; Cloud 66 normally returns up to 30 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 Clusters

**Slug:** `CLOUD_66_LIST_CLUSTERS`

Return one documented page of Kubernetes clusters accessible to the user. Each call returns one page, currently up to 100 clusters. This documented route returned an HTML 404 in prior probing, so availability may depend on the account or provider deployment.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `next_cursor` | string | No | Opaque continuation cursor returned by the previous call. Omit it for the first page; Cloud 66 documents up to 100 clusters 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 Containers

**Slug:** `CLOUD_66_LIST_CONTAINERS`

Gets containers for a Cloud 66 stack, optionally filtered by server. Each call returns one page, normally up to 30 items.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `stack_id` | string | Yes | UID of the stack whose containers to list. |
| `server_uid` | string | No | Server UID to filter containers by. |
| `next_cursor` | string | No | Opaque continuation cursor returned by the previous call. Omit it for the first page; Cloud 66 normally returns up to 30 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 Databases

**Slug:** `CLOUD_66_LIST_DATABASES`

Returns one page of databases associated with a Cloud 66 server group; Cloud 66 normally returns up to 30 items per page.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `stack_id` | string | Yes | UID of the stack that owns the server group. |
| `next_cursor` | string | No | Opaque continuation cursor returned by the previous call. Omit it for the first page; Cloud 66 normally returns up to 30 items per page. |
| `server_group_id` | integer | Yes | Numeric ID of the server group whose databases to list. |

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

**Slug:** `CLOUD_66_LIST_DATABASE_USERS`

Gets one page of database-user names and metadata for a Cloud 66 server group. Passwords and password hashes are never requested or returned. Cloud 66 normally returns up to 30 items per page.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `stack_id` | string | Yes | UID of the stack that owns the server group. |
| `next_cursor` | string | No | Opaque continuation cursor returned by the previous call. Omit it for the first page; Cloud 66 normally returns up to 30 items per page. |
| `server_group_id` | integer | Yes | Numeric ID of the server group whose database users to list. |

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

**Slug:** `CLOUD_66_LIST_DEPLOYMENTS`

Gets one page of deployments for a Cloud 66 stack; Cloud 66 normally returns up to 30 items per page.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `stack_id` | string | Yes | UID of the stack whose deployments to list. |
| `next_cursor` | string | No | Opaque continuation cursor returned by the previous call. Omit it for the first page; Cloud 66 normally returns up to 30 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 DNS Providers

**Slug:** `CLOUD_66_LIST_DNS_PROVIDERS`

Gets one page of DNS providers configured for SSL certificate management; Cloud 66 normally returns up to 30 items per page.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `next_cursor` | string | No | Opaque continuation cursor returned by the previous call. Omit it for the first page; Cloud 66 normally returns up to 30 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 Elastic Addresses

**Slug:** `CLOUD_66_LIST_ELASTIC_ADDRESSES`

Return Cloud 66's documented elastic-address failover groups. This documented route returned an HTML 404 in prior probing without a scope or paid-tier signal, so its availability is unresolved.

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

**Slug:** `CLOUD_66_LIST_ENVIRONMENT_VARIABLES`

Get one page of environment-variable names and metadata for a Cloud 66 stack. Current and historical values are never returned. Cloud 66 normally returns up to 30 items per page.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `stack_id` | string | Yes | UID of the stack whose environment variables to list. |
| `next_cursor` | string | No | Opaque continuation cursor returned by the previous call. Omit it for the first page; Cloud 66 normally returns up to 30 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 Firewall Rules

**Slug:** `CLOUD_66_LIST_FIREWALL_RULES`

Gets one page of firewall rules for a Cloud 66 stack; Cloud 66 normally returns up to 30 items per page.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `stack_id` | string | Yes | UID of the stack whose firewall rules to list. |
| `next_cursor` | string | No | Opaque continuation cursor returned by the previous call. Omit it for the first page; Cloud 66 normally returns up to 30 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 Gateways

**Slug:** `CLOUD_66_LIST_GATEWAYS`

Gets one page of gateway metadata for a Cloud 66 account. Private-key content is never returned. Cloud 66 normally returns up to 30 items per page.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `account_id` | string | Yes | ID of the Cloud 66 account whose gateways to list. |
| `next_cursor` | string | No | Opaque continuation cursor returned by the previous call. Omit it for the first page; Cloud 66 normally returns up to 30 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 Image Repositories

**Slug:** `CLOUD_66_LIST_IMAGE_REPOSITORIES`

Gets one page of image repositories for a Cloud 66 stack; Cloud 66 normally returns up to 30 items per page.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `stack_id` | string | Yes | UID of the stack whose image repositories to list. |
| `next_cursor` | string | No | Opaque continuation cursor returned by the previous call. Omit it for the first page; Cloud 66 normally returns up to 30 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 Jobs

**Slug:** `CLOUD_66_LIST_JOBS`

Gets one page of jobs configured on a Cloud 66 stack, including each job's command and run_on server-target context. Cloud 66 normally returns up to 30 items per page.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `stack_id` | string | Yes | UID of the stack whose jobs to list. |
| `next_cursor` | string | No | Opaque continuation cursor returned by the previous call. Omit it for the first page; Cloud 66 normally returns up to 30 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 Notifications

**Slug:** `CLOUD_66_LIST_NOTIFICATIONS`

Return one documented page of Cloud 66 notification records. Each call returns one page, normally up to 30 items. This documented route returned an HTML 404 in prior probing, so availability may depend on the account or provider deployment.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `next_cursor` | string | No | Opaque continuation cursor returned by the previous call. Omit it for the first page; Cloud 66 normally returns up to 30 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 Processes

**Slug:** `CLOUD_66_LIST_PROCESSES`

Gets one page of processes for a Cloud 66 stack, optionally filtered by server; Cloud 66 normally returns up to 30 items per page.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `stack_id` | string | Yes | UID of the stack whose processes to list. |
| `server_uid` | string | No | UID of a server by which to filter processes. |
| `next_cursor` | string | No | Opaque continuation cursor returned by the previous call. Omit it for the first page; Cloud 66 normally returns up to 30 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 Server Groups

**Slug:** `CLOUD_66_LIST_SERVER_GROUPS`

Gets one page of server groups for a Cloud 66 stack; Cloud 66 normally returns up to 30 items per page.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `stack_id` | string | Yes | UID of the stack whose server groups to list. |
| `next_cursor` | string | No | Opaque continuation cursor returned by the previous call. Omit it for the first page; Cloud 66 normally returns up to 30 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 Servers

**Slug:** `CLOUD_66_LIST_SERVERS`

Gets one page of servers for a Cloud 66 stack; Cloud 66 normally returns up to 30 items per page.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `stack_id` | string | Yes | UID of the stack whose servers to list. |
| `next_cursor` | string | No | Opaque continuation cursor returned by the previous call. Omit it for the first page; Cloud 66 normally returns up to 30 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 Server Settings

**Slug:** `CLOUD_66_LIST_SERVER_SETTINGS`

Returns one page of settings for a server, including optional IDs, timestamps, and warnings when Cloud 66 provides them; Cloud 66 normally returns up to 30 items per page.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `stack_id` | string | Yes | UID of the stack that owns the server. |
| `server_id` | string | Yes | UID of the server whose settings to list. |
| `next_cursor` | string | No | Opaque continuation cursor returned by the previous call. Omit it for the first page; Cloud 66 normally returns up to 30 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 Services

**Slug:** `CLOUD_66_LIST_SERVICES`

Gets one page of services for a Cloud 66 stack; Cloud 66 normally returns up to 30 items per page.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `stack_id` | string | Yes | UID of the stack whose services to list. |
| `next_cursor` | string | No | Opaque continuation cursor returned by the previous call. Omit it for the first page; Cloud 66 normally returns up to 30 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 SSL Certificates

**Slug:** `CLOUD_66_LIST_SSL_CERTIFICATES`

Gets one page of SSL certificate metadata for a Cloud 66 stack. Certificate and private-key material is never returned. Cloud 66 normally returns up to 30 items per page.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `stack_id` | string | Yes | Unique identifier of the stack whose SSL certificates to list. |
| `next_cursor` | string | No | Opaque continuation cursor returned by the previous call. Omit it for the first page; Cloud 66 normally returns up to 30 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 Stack Actions

**Slug:** `CLOUD_66_LIST_STACK_ACTIONS`

Retrieve one page of asynchronous actions performed for a Cloud 66 stack, optionally filtered by caller reference; Cloud 66 normally returns up to 30 items per page.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | Unique identifier of the stack whose asynchronous actions to list. |
| `next_cursor` | string | No | Opaque continuation cursor returned by the previous call. Omit it for the first page; Cloud 66 normally returns up to 30 items per page. |
| `user_reference` | string | No | Return only actions whose caller-provided metadata matches this reference. |

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

**Slug:** `CLOUD_66_LIST_STACK_ALERTS`

Returns the alert configurations and notification channels for a specified stack.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `stack_id` | string | Yes | UID of the stack whose alert configurations to list. |

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

**Slug:** `CLOUD_66_LIST_STACKS`

Retrieves stack objects accessible to the current user. Each call returns one page, currently up to 100 stacks.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `next_cursor` | string | No | Opaque continuation cursor returned by the previous call. Omit it for the first page; the live stacks endpoint currently returns up to 100 stacks 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 Stack Settings

**Slug:** `CLOUD_66_LIST_STACK_SETTINGS`

Returns one page of settings for a Cloud 66 stack, including their values and read-only status; Cloud 66 normally returns up to 30 items per page.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `stack_id` | string | Yes | UID of the stack whose settings to list. |
| `next_cursor` | string | No | Opaque continuation cursor returned by the previous call. Omit it for the first page; Cloud 66 normally returns up to 30 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 Tags

**Slug:** `CLOUD_66_LIST_TAGS`

Gets one page of tags for a Cloud 66 server or load balancer, identified by entity type and ID. Cloud 66 normally returns up to 30 items per page.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `entity_id` | string | Yes | ID of the server or load balancer whose tags to list. |
| `entity_type` | string ("server" | "loadbalancer") | Yes | Type of Cloud 66 entity whose tags to list: server or loadbalancer. |
| `next_cursor` | string | No | Opaque continuation cursor returned by the previous call. Omit it for the first page; Cloud 66 normally returns up to 30 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 Users

**Slug:** `CLOUD_66_LIST_USERS`

Gets one page of users in the connected Cloud 66 account, including account roles and access-profile details when available. Cloud 66 normally returns up to 30 items per page.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `next_cursor` | string | No | Opaque continuation cursor returned by the previous call. Omit it for the first page; Cloud 66 normally returns up to 30 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 |

### Patch SSL Certificate

**Slug:** `CLOUD_66_PATCH_SSL_CERTIFICATE`

Update a Let's Encrypt SSL certificate using Cloud 66's PATCH method. Manual certificate and private-key uploads are excluded. Cloud 66 does not distinguish PATCH from PUT semantics. Success confirms request acceptance only.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `type` | string | Yes | Automatic Let's Encrypt provisioning; manual private-key uploads are excluded. |
| `stack_id` | string | Yes | Unique identifier of the stack. |
| `wildcard` | boolean | Yes | Whether the certificate supports wildcard domains; required by the PATCH endpoint. |
| `server_names` | string | Yes | Comma-separated domain names covered by the certificate. |
| `ssl_termination` | boolean | Yes | Whether Cloud 66 terminates SSL on the load balancer. |
| `dns_provider_uuid` | string | No | DNS provider UUID required for a wildcard Let's Encrypt certificate. |
| `ssl_certificate_id` | string | Yes | Unique identifier of the SSL certificate to update. |

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

### Pause Stack Workload

**Slug:** `CLOUD_66_PAUSE_WORKLOAD`

Pause a Cloud 66 service or process workload. Services require service_name, server_uid, or both; processes require process_name, server_uid, or both. By setting all_workloads=true without either selector, the action broadly pauses every workload of the selected type across the stack. Pausing workloads is disruptive; the accepted asynchronous job is returned by default.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `stack_id` | string | Yes | Unique identifier of the stack on which to run the action. |
| `server_uid` | string | No | Server selector on which to control the service or process. Provide server_uid, the matching workload name, or both. |
| `target_type` | string ("service" | "process") | Yes | Type of workload to control. Provide its matching name, server_uid, or both, unless all_workloads is explicitly true. |
| `process_name` | string | No | Process selector used when target_type is process. Provide process_name, server_uid, or both. |
| `service_name` | string | No | Service selector used when target_type is service. Provide service_name, server_uid, or both. |
| `all_workloads` | boolean | No | Set true only to apply the action to every workload of the selected service or process type across the stack. This is a broad, disruptive update and cannot be combined with a workload name or server_uid. Omit or leave false to require a selector. |
| `timeout_seconds` | number | No | Maximum seconds to wait within the tool execution window. |
| `wait_for_completion` | boolean | No | Return after Cloud 66 accepts the asynchronous job by default. Set true to poll within the bounded tool execution window. |
| `poll_interval_seconds` | number | No | Seconds between action-status checks when waiting. |

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

### Promote Database Replica

**Slug:** `CLOUD_66_PROMOTE_DATABASE_REPLICA`

Promote a Cloud 66 slave database server to a standalone master and return the accepted irreversible asynchronous job by default.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `db_type` | string ("postgresql" | "redis" | "mysql") | No | Database type of the slave server. |
| `stack_id` | string | Yes | Unique identifier of the stack on which to run the action. |
| `server_uid` | string | Yes | UID of the slave database server. |
| `timeout_seconds` | number | No | Maximum seconds to wait within the tool execution window. |
| `wait_for_completion` | boolean | No | Return after Cloud 66 accepts the asynchronous job by default. Set true to poll within the bounded tool execution window. |
| `poll_interval_seconds` | number | No | Seconds between action-status checks when waiting. |

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

### Put SSL Certificate

**Slug:** `CLOUD_66_PUT_SSL_CERTIFICATE`

Update a Let's Encrypt SSL certificate using Cloud 66's PUT method. Manual certificate and private-key uploads are excluded. Cloud 66 does not distinguish PUT from PATCH semantics. Success confirms request acceptance only.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `type` | string | Yes | Automatic Let's Encrypt provisioning; manual private-key uploads are excluded. |
| `stack_id` | string | Yes | Unique identifier of the stack. |
| `wildcard` | boolean | Yes | Whether the certificate supports wildcard domains; required by the PUT endpoint. |
| `server_names` | string | Yes | Comma-separated domain names covered by the certificate. |
| `ssl_termination` | boolean | Yes | Whether Cloud 66 terminates SSL on the load balancer. |
| `dns_provider_uuid` | string | No | DNS provider UUID required for a wildcard Let's Encrypt certificate. |
| `ssl_certificate_id` | string | Yes | Unique identifier of the SSL certificate to update. |

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

### Reboot Cluster Servers

**Slug:** `CLOUD_66_REBOOT_CLUSTER_SERVERS`

Queue an irreversible reboot of selected Kubernetes cluster servers. A non-terminal result confirms acceptance only because Cloud 66 does not return a documented stack UID that can safely route action-status polling.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | UID of the Kubernetes cluster whose servers should be rebooted. |
| `group` | string | No | Server group to reboot, such as all, web, db, redis, or mysql. |
| `strategy` | string ("parallel" | "serial") | No | Reboot strategy. Parallel reboots together; serial reboots in sequence. |

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

### Reboot Server

**Slug:** `CLOUD_66_REBOOT_SERVER`

Initiate an irreversible reboot of one Cloud 66 server. A successful result confirms acceptance only; this endpoint does not confirm that the server finished rebooting.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `stack_id` | string | Yes | UID of the stack that owns the server. |
| `server_id` | string | Yes | UID of the server to reboot. |

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

### Reboot Stack Servers

**Slug:** `CLOUD_66_REBOOT_STACK_SERVERS`

Reboot all servers or one server group in a Cloud 66 stack using a parallel or serial strategy, and by default wait for documented asynchronous completion.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `group` | string | No | Server group to reboot, such as all, web, db, redis, or mysql; Cloud 66 defaults to web. |
| `stack_id` | string | Yes | Unique identifier of the stack whose servers should be rebooted. |
| `strategy` | string ("parallel" | "serial") | Yes | Reboot strategy: parallel reboots together; serial reboots in sequence. |
| `timeout_seconds` | number | No | Maximum total seconds to wait for a terminal reboot result. |
| `wait_for_completion` | boolean | No | Wait for the asynchronous reboot action to finish before returning. |
| `poll_interval_seconds` | number | No | Seconds between action-status checks when waiting. |

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

### Redeploy Stack

**Slug:** `CLOUD_66_REDEPLOY_STACK`

Redeploy a Cloud 66 stack. This changes its running deployment and returns the accepted asynchronous action by default because deployments commonly outlast the tool execution window.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `git_ref` | string | No | Git branch, tag, or commit to deploy for a non-Docker stack. |
| `services` | string | No | Docker services and images to deploy, as a comma-separated mapping. |
| `stack_id` | string | Yes | UID of the stack to redeploy. |
| `user_reference` | string | No | Caller reference stored in the stack action metadata, up to 255 characters. |
| `timeout_seconds` | number | No | Maximum total seconds to wait for a terminal action state. |
| `deployment_profile` | string | No | Deployment profile to use for this redeploy. |
| `wait_for_completion` | boolean | No | Return after Cloud 66 accepts the redeploy by default. Set true only when a longer-running caller can tolerate deployment polling. |
| `poll_interval_seconds` | number | No | Seconds between deployment-status checks when waiting. |

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

### Replace Tags

**Slug:** `CLOUD_66_REPLACE_TAGS`

Replace all tags on one Cloud 66 server or load balancer with the supplied non-empty tag set.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `tags` | array | Yes | Complete replacement set of tags. This operation replaces all current tags on the entity; use the tag-update tool for incremental changes. |
| `entity_id` | string | Yes | ID of the server or load balancer whose tags will be replaced. |
| `entity_type` | string ("server" | "loadbalancer") | Yes | Type of Cloud 66 entity whose tags will be replaced: server or loadbalancer. |

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

### Restart Stack

**Slug:** `CLOUD_66_RESTART_STACK`

Restart every component of a Cloud 66 stack and return the accepted asynchronous job by default. The restart is disruptive.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `stack_id` | string | Yes | Unique identifier of the stack on which to run the action. |
| `timeout_seconds` | number | No | Maximum seconds to wait within the tool execution window. |
| `wait_for_completion` | boolean | No | Return after Cloud 66 accepts the asynchronous job by default. Set true to poll within the bounded tool execution window. |
| `poll_interval_seconds` | number | No | Seconds between action-status checks when waiting. |

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

### Restart Stack Workload

**Slug:** `CLOUD_66_RESTART_WORKLOAD`

Restart a Cloud 66 container, service, or process workload. Containers require container_id. Services require service_name, server_uid, or both; processes require process_name, server_uid, or both. Set all_workloads=true without either selector to restart every workload of the selected type across the stack. Restarts are disruptive and irreversible once initiated; the accepted asynchronous job is returned by default.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `stack_id` | string | Yes | Unique identifier of the stack on which to run the action. |
| `server_uid` | string | No | Server selector for a service or process restart. Provide server_uid, the matching workload name, or both. |
| `target_type` | string ("container" | "service" | "process") | Yes | Type of workload to restart. container requires container_id; service and process require their matching name or server_uid unless all_workloads is explicitly true. |
| `container_id` | string | No | Container ID or name. Required when target_type is container. |
| `process_name` | string | No | Process selector used when target_type is process. Provide process_name, server_uid, or both. |
| `service_name` | string | No | Service selector used when target_type is service. Provide service_name, server_uid, or both. |
| `all_workloads` | boolean | No | Set true only to restart every workload of the selected service or process type across the stack. This is a broad, disruptive, irreversible action and cannot be combined with a workload name or server_uid. Omit or leave false to require a selector. |
| `timeout_seconds` | number | No | Maximum seconds to wait within the tool execution window. |
| `wait_for_completion` | boolean | No | Return after Cloud 66 accepts the asynchronous job by default. Set true to poll within the bounded tool execution window. |
| `poll_interval_seconds` | number | No | Seconds between action-status checks when waiting. |

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

### Resume Stack Workload

**Slug:** `CLOUD_66_RESUME_WORKLOAD`

Resume a Cloud 66 service or process workload. Services require service_name, server_uid, or both; processes require process_name, server_uid, or both. By setting all_workloads=true without either selector, the action broadly resumes every workload of the selected type across the stack. Resuming workloads is disruptive; the accepted asynchronous job is returned by default.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `stack_id` | string | Yes | Unique identifier of the stack on which to run the action. |
| `server_uid` | string | No | Server selector on which to control the service or process. Provide server_uid, the matching workload name, or both. |
| `target_type` | string ("service" | "process") | Yes | Type of workload to control. Provide its matching name, server_uid, or both, unless all_workloads is explicitly true. |
| `process_name` | string | No | Process selector used when target_type is process. Provide process_name, server_uid, or both. |
| `service_name` | string | No | Service selector used when target_type is service. Provide service_name, server_uid, or both. |
| `all_workloads` | boolean | No | Set true only to apply the action to every workload of the selected service or process type across the stack. This is a broad, disruptive update and cannot be combined with a workload name or server_uid. Omit or leave false to require a selector. |
| `timeout_seconds` | number | No | Maximum seconds to wait within the tool execution window. |
| `wait_for_completion` | boolean | No | Return after Cloud 66 accepts the asynchronous job by default. Set true to poll within the bounded tool execution window. |
| `poll_interval_seconds` | number | No | Seconds between action-status checks when waiting. |

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

### Resync Database Replica

**Slug:** `CLOUD_66_RESYNC_DATABASE_REPLICA`

Re-synchronize a PostgreSQL or MySQL Cloud 66 slave database server with its master and return the accepted asynchronous job by default. The replica's current data may be replaced.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `db_type` | string ("postgresql" | "mysql") | No | Database type of the slave server. |
| `stack_id` | string | Yes | Unique identifier of the stack on which to run the action. |
| `server_uid` | string | Yes | UID of the slave database server to re-synchronize. |
| `timeout_seconds` | number | No | Maximum seconds to wait within the tool execution window. |
| `wait_for_completion` | boolean | No | Return after Cloud 66 accepts the asynchronous job by default. Set true to poll within the bounded tool execution window. |
| `poll_interval_seconds` | number | No | Seconds between action-status checks when waiting. |

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

### Scale Process

**Slug:** `CLOUD_66_SCALE_PROCESS`

Trigger the provider-configured scaling operation for a process on a Cloud 66 stack and, by default, poll until Cloud 66 confirms success. This tool cannot set a desired process count; scaling behavior comes from the process's existing Cloud 66 configuration.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | Identifier of the process to scale. |
| `stack_id` | string | Yes | UID of the stack that owns the process. |
| `timeout_seconds` | number | No | Maximum total seconds to wait for a terminal action state. |
| `wait_for_completion` | boolean | No | Wait for the asynchronous scale action to finish before returning. |
| `poll_interval_seconds` | number | No | Seconds between action-status checks when waiting. |

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

### Set Stack Maintenance Mode

**Slug:** `CLOUD_66_SET_STACK_MAINTENANCE_MODE`

Enable or disable maintenance mode for a Cloud 66 stack. By default this returns the accepted asynchronous job because Cloud 66 can take 70-120 seconds to mark it complete.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `value` | integer ("0" | "1") | Yes | Maintenance-mode state: 1 enables maintenance mode and 0 disables it. |
| `stack_id` | string | Yes | Unique identifier of the stack on which to run the action. |
| `timeout_seconds` | number | No | Maximum seconds to wait within the tool execution window. |
| `wait_for_completion` | boolean | No | Return after Cloud 66 accepts the asynchronous job by default. Set true to poll within the bounded tool execution window. |
| `poll_interval_seconds` | number | No | Seconds between action-status checks when waiting. |

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

### Stop Container

**Slug:** `CLOUD_66_STOP_CONTAINER`

Stop a container in a Cloud 66 stack. This changes the container's running state and can interrupt workloads.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `stack_id` | string | Yes | UID of the stack that owns the container. |
| `container_id` | string | Yes | UID of the container to stop. |

#### 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 Application Group Alerts

**Slug:** `CLOUD_66_UPDATE_APPLICATION_GROUP_ALERTS`

Apply alert configurations to every stack in a Cloud 66 application group and report successes, non-applicable alerts, and failures.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `alerts` | array | Yes | Alert configurations to apply to every stack in the application group. |
| `application_group_name` | string | Yes | Name of the application group whose alert settings will be updated. |

#### 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 Application Variant Percentage

**Slug:** `CLOUD_66_UPDATE_APPLICATION_VARIANT_PERCENTAGE`

Change the percentage of production traffic sent to a canary rollout application variant. This action applies only to canary deployments.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | UID of the canary application variant to update. |
| `stack_id` | string | Yes | UID of the stack that owns the canary application variant. |
| `canary_percentage` | integer | Yes | New percentage of production traffic to send to the canary, from 0 to 100. |

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

**Slug:** `CLOUD_66_UPDATE_ELASTIC_ADDRESS`

Update an elastic address's primary or secondary stack assignment, or switch which stack currently receives traffic. Provide at least one of primary_stack_uid, secondary_stack_uid, or current_stack.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `uid` | string | Yes | UID of the elastic address (failover group) to update. |
| `current_stack` | string ("primary" | "secondary") | No | Stack that should currently receive traffic. Provide at least one of primary_stack_uid, secondary_stack_uid, or current_stack. |
| `primary_stack_uid` | string | No | UID of the stack to assign as the primary failover target. Provide at least one of primary_stack_uid, secondary_stack_uid, or current_stack. |
| `secondary_stack_uid` | string | No | UID of the stack to assign as the secondary failover target. Provide at least one of primary_stack_uid, secondary_stack_uid, or current_stack. |

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

**Slug:** `CLOUD_66_UPDATE_GATEWAY`

Update a Cloud 66 gateway's bastion-server metadata without accepting or returning private-key content. Provide at least one of name, username, address, ttl, or private_ip.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | integer | Yes | ID of the gateway to update. |
| `ttl` | integer | No | New number of seconds the gateway should remain available. Provide at least one gateway field to update. |
| `name` | string | No | New gateway name. Provide at least one gateway field to update. |
| `address` | string | No | New public IP address or DNS name of the bastion server. Provide at least one gateway field to update. |
| `username` | string | No | New username for the bastion server. Provide at least one gateway field to update. |
| `account_id` | string | Yes | ID of the Cloud 66 account that owns the gateway. |
| `private_ip` | string | No | New private IP address or DNS name of the bastion server. Provide at least one gateway field to update. |

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

**Slug:** `CLOUD_66_UPDATE_SERVER_SETTING`

Update one server setting in a Cloud 66 stack and, by default, poll the asynchronous action until Cloud 66 confirms success.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | Identifier of the server setting to update. |
| `value` | string | Yes | New string value for the server setting. |
| `stack_id` | string | Yes | UID of the stack that owns the server. |
| `server_id` | string | Yes | UID of the server that owns the setting. |
| `timeout_seconds` | number | No | Maximum total seconds to wait for a terminal action state. |
| `wait_for_completion` | boolean | No | Wait for the asynchronous setting update to finish before returning. |
| `poll_interval_seconds` | number | No | Seconds between action-status checks when waiting. |

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

**Slug:** `CLOUD_66_UPDATE_STACK_ALERTS`

Update one or more Cloud 66 stack alert configurations. Only specified alerts are changed; other stack alert settings remain unchanged.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `alerts` | object | Yes | Alert configurations keyed by supported Cloud 66 alert name. Only the specified alerts are modified. |
| `stack_id` | string | Yes | UID of the stack whose alert configurations will be updated. |

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

**Slug:** `CLOUD_66_UPDATE_STACK_SETTING`

Update one Cloud 66 stack setting and, by default, poll the asynchronous action until Cloud 66 confirms success.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | Identifier of the stack setting to update. |
| `value` | string | Yes | New string value for the stack setting. |
| `stack_id` | string | Yes | UID of the stack that owns the setting. |
| `timeout_seconds` | number | No | Maximum total seconds to wait for a terminal action state. |
| `wait_for_completion` | boolean | No | Wait for the asynchronous setting update to finish before returning. |
| `poll_interval_seconds` | number | No | Seconds between action-status checks when waiting. |

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

**Slug:** `CLOUD_66_UPDATE_TAGS`

Incrementally add or delete tags on one Cloud 66 server or load balancer. Deleting a tag that is not present is ignored; Cloud 66 performs deletions before additions.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `entity_id` | string | Yes | ID of the server or load balancer whose tags will be updated. |
| `operations` | array | Yes | Tag changes to apply. Each item adds or deletes its tags; deleting a missing tag is ignored, and Cloud 66 performs all deletions before additions. |
| `entity_type` | string ("server" | "loadbalancer") | Yes | Type of Cloud 66 entity whose tags will be updated. |

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

**Slug:** `CLOUD_66_UPDATE_USER`

Update a Cloud 66 user's access profile. This changes account permissions and stack roles for a human user; verify the target user and intended access before calling. Cloud 66 ignores user fields outside access_profile.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | integer | Yes | The Cloud 66 user ID whose access profile will be updated. |
| `access_profile` | object | Yes | Access-profile changes to apply. Cloud 66 documents that other user information is ignored by this endpoint. |

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