The Linode (Akamai Cloud) connector lets your AI agent act in each user's Linode (Akamai Cloud) account. Each user connects their own Linode (Akamai Cloud) access token once, and Scalekit sends it with every call, so your agent never handles credentials. It comes with 60 tools.
- Tools
- 60
- What they doRead · write · destructive
- 33 · 20 · 733 read20 write7 destructive
- Users sign in with
- Access token
Setup
Install the SDK
Terminal window npm install @scalekit-sdk/node dotenvTerminal window pip install scalekit-sdk-python python-dotenvSet your credentials
Add your Scalekit credentials to your
.envfile. Find values in app.scalekit.com > Developers > API Credentials..env SCALEKIT_ENVIRONMENT_URL=<your-environment-url>SCALEKIT_CLIENT_ID=<your-client-id>SCALEKIT_CLIENT_SECRET=<your-client-secret>Create the Linode (Akamai Cloud) connection
In AgentKit > Connections, create a Linode (Akamai Cloud) connection. The name you give it is the
connection_nameyour code passes. See Configure connections.Authorize a user and make your first call
quickstart.mts import { ScalekitClient } from '@scalekit-sdk/node'import 'dotenv/config'import { createInterface } from 'node:readline/promises'const scalekit = new ScalekitClient(process.env.SCALEKIT_ENVIRONMENT_URL,process.env.SCALEKIT_CLIENT_ID,process.env.SCALEKIT_CLIENT_SECRET,)const actions = scalekit.actionsconst connector = 'linode'const identifier = 'user_123'// Generate an authorization link for the userconst { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })console.log('Authorize Linode (Akamai Cloud):', link)const rl = createInterface({ input: process.stdin, output: process.stdout })await rl.question('Press Enter after authorizing...')rl.close()// Make your first callconst result = await actions.executeTool({connector,identifier,toolName: 'linode_account_get',toolInput: {},})console.log(result)Terminal window npx tsx quickstart.mtsquickstart.py import osfrom scalekit import ScalekitClientfrom dotenv import load_dotenvload_dotenv()scalekit_client = ScalekitClient(env_url=os.getenv("SCALEKIT_ENVIRONMENT_URL"),client_id=os.getenv("SCALEKIT_CLIENT_ID"),client_secret=os.getenv("SCALEKIT_CLIENT_SECRET"),)actions = scalekit_client.actionsconnection_name = "linode"identifier = "user_123"# Generate an authorization link for the userlink_response = actions.get_authorization_link(connection_name=connection_name,identifier=identifier,)print("Authorize Linode (Akamai Cloud):", link_response.link)input("Press Enter after authorizing...")# Make your first callresult = actions.execute_tool(tool_input={},tool_name="linode_account_get",connection_name=connection_name,identifier=identifier,)print(result)Terminal window python quickstart.pyEach user opens the link once and enters their Linode (Akamai Cloud) credentials there. See Authorize a user for the full flow and statuses.
Tools
Pass the exact name toexecute_toollinode_account_getGet the account contact details, balance and active services.Read-onlyGet Account
Get the account contact details, balance and active services. Returns an object with active_promotions, active_since, address_1, address_2, balance, balance_uninvoiced, billing_source, capabilities, city, company, and more. Use linode_account_get for billing and contact info. Use linode_profile_get for the token user.
Inputs
This tool takes no inputs.
linode_domain_getGet one DNS domain with its SOA email, type and status.Read-onlyGet Domain
Get one DNS domain with its SOA email, type and status. Returns an object with axfr_ips, description, domain, expire_sec, group, id, master_ips, refresh_sec, retry_sec, soa_email, and more. Use linode_domain_get for one domain. Use linode_domain_records_list for its records.
Inputs
domain_idintegerrequired- Domain ID, from linode_domains_list. Example: 1234
linode_domain_records_listList the DNS records of a domain.Read-onlyList DNS Records
List the DNS records of a domain. Returns data[] (each with created, id, name, port, priority, protocol, service, tag) plus page, pages, results. Use linode_domain_records_list to find a record ID.
Inputs
domain_idintegerrequired- Domain ID, from linode_domains_list. Example: 1234
pageinteger- Page number to return, starting at 1. Example: 1
page_sizeinteger- Results per page, 25 to 500 (default 100). Example: 100
linode_domains_listList the domains in the Linode DNS Manager.Read-onlyList Domains
List the domains in the Linode DNS Manager. Returns data[] (each with axfr_ips, description, domain, expire_sec, group, id, master_ips, refresh_sec) plus page, pages, results. Use linode_domains_list to find a domain ID.
Inputs
pageinteger- Page number to return, starting at 1. Example: 1
page_sizeinteger- Results per page, 25 to 500 (default 100). Example: 100
linode_event_getGet one event with its action, status, progress and entity.Read-onlyGet Event
Get one event with its action, status, progress and entity. Returns an object with action, created, details, duration, entity, id, message, percent_complete, rate, secondary_entity, and more. Use linode_event_get to poll the progress of an operation.
Inputs
event_idintegerrequired- Event ID. Example: 123
linode_events_listList account events (actions such as Linode boots, creates and deletes), newest first.Read-onlyList Events
List account events (actions such as Linode boots, creates and deletes), newest first. Returns data[] (each with action, created, details, duration, entity, id, message, percent_complete) plus page, pages, results. Use linode_events_list to follow async operations. Use linode_event_get for one event.
Inputs
pageinteger- Page number to return, starting at 1. Example: 1
page_sizeinteger- Results per page, 25 to 500 (default 100). Example: 100
linode_firewall_devices_listList the Linodes and NodeBalancers a firewall is assigned to.Read-onlyList Firewall Devices
List the Linodes and NodeBalancers a firewall is assigned to. Returns data[] (each with created, entity, id, updated) plus page, pages, results. Use linode_firewall_devices_list to see what a firewall protects.
Inputs
firewall_idintegerrequired- Firewall ID, from linode_firewalls_list. Example: 1234
pageinteger- Page number to return, starting at 1. Example: 1
page_sizeinteger- Results per page, 25 to 500 (default 100). Example: 100
linode_firewall_getGet one Cloud Firewall with its rules and status.Read-onlyGet Firewall
Get one Cloud Firewall with its rules and status. Returns an object with created, entities, id, label, rules, status, tags, updated. Use linode_firewall_get for one firewall.
Inputs
firewall_idintegerrequired- Firewall ID, from linode_firewalls_list. Example: 1234
linode_firewalls_listList Cloud Firewalls.Read-onlyList Firewalls
List Cloud Firewalls. Returns data[] (each with created, entities, id, label, rules, status, tags, updated) plus page, pages, results. Use linode_firewalls_list to find a firewall ID.
Inputs
pageinteger- Page number to return, starting at 1. Example: 1
page_sizeinteger- Results per page, 25 to 500 (default 100). Example: 100
linode_image_getGet one image.Read-onlyGet Image
Get one image. Returns an object with capabilities, created, created_by, deprecated, description, eol, expiry, id, image_sharing, is_public, and more. Use linode_image_get for one image.
Inputs
image_idstringrequired- Image ID. Example: linode/ubuntu24.04
linode_images_listList public distribution images and your private images.Read-onlyList Images
List public distribution images and your private images. Returns data[] (each with capabilities, created, created_by, deprecated, description, eol, expiry, id) plus page, pages, results. Use linode_images_list to pick an image ID for linode_instance_create.
Inputs
pageinteger- Page number to return, starting at 1. Example: 1
page_sizeinteger- Results per page, 25 to 500 (default 100). Example: 100
linode_instance_backups_listList the automatic backups and snapshot of a Linode.Read-onlyList Linode Backups
List the automatic backups and snapshot of a Linode. Returns an object with automatic, snapshot. Use linode_instance_backups_list to find a backup to restore.
Inputs
linode_idintegerrequired- Linode instance ID, from linode_instances_list. Example: 123456
linode_instance_configs_listList the configuration profiles (kernel, devices, interfaces) of a Linode.Read-onlyList Linode Configs
List the configuration profiles (kernel, devices, interfaces) of a Linode. Returns data[] (each with comments, devices, helpers, id, interfaces, kernel, label, memory_limit) plus page, pages, results. Use linode_instance_configs_list to inspect boot settings.
Inputs
linode_idintegerrequired- Linode instance ID, from linode_instances_list. Example: 123456
pageinteger- Page number to return, starting at 1. Example: 1
page_sizeinteger- Results per page, 25 to 500 (default 100). Example: 100
linode_instance_disks_listList the disks of a Linode.Read-onlyList Linode Disks
List the disks of a Linode. Returns data[] (each with created, disk_encryption, filesystem, id, label, size, status, updated) plus page, pages, results. Use linode_instance_disks_list to find a disk ID for linode_image_create.
Inputs
linode_idintegerrequired- Linode instance ID, from linode_instances_list. Example: 123456
pageinteger- Page number to return, starting at 1. Example: 1
page_sizeinteger- Results per page, 25 to 500 (default 100). Example: 100
linode_instance_firewalls_listList the Cloud Firewalls assigned to a Linode.Read-onlyList Linode Firewalls
List the Cloud Firewalls assigned to a Linode. Returns data[] (each with created, entities, id, label, rules, status, tags, updated) plus page, pages, results. Use linode_instance_firewalls_list for one Linode. Use linode_firewalls_list for all firewalls.
Inputs
linode_idintegerrequired- Linode instance ID, from linode_instances_list. Example: 123456
pageinteger- Page number to return, starting at 1. Example: 1
page_sizeinteger- Results per page, 25 to 500 (default 100). Example: 100
linode_instance_getGet one Linode instance with its status, specs, IPs and backups setting.Read-onlyGet Linode
Get one Linode instance with its status, specs, IPs and backups setting. Returns an object with alerts, backups, capabilities, created, disk_encryption, group, has_user_data, host_uuid, hypervisor, id, and more. Use linode_instance_get for one Linode.
Inputs
linode_idintegerrequired- Linode instance ID, from linode_instances_list. Example: 123456
linode_instance_ips_getGet the IPv4 and IPv6 addresses of a Linode.Read-onlyGet Linode IPs
Get the IPv4 and IPv6 addresses of a Linode. Returns an object with ipv4, ipv6. Use linode_instance_ips_get to find a server address.
Inputs
linode_idintegerrequired- Linode instance ID, from linode_instances_list. Example: 123456
linode_instance_stats_getGet CPU, disk IO and network usage of a Linode for the last 24 hours.Read-onlyGet Linode Stats
Get CPU, disk IO and network usage of a Linode for the last 24 hours. Returns an object with cpu, io, netv4, netv6, title. Use linode_instance_stats_get to check load. Use linode_instance_transfer_get for monthly transfer.
Inputs
linode_idintegerrequired- Linode instance ID, from linode_instances_list. Example: 123456
linode_instance_transfer_getGet the network transfer a Linode used this month against its quota.Read-onlyGet Linode Transfer
Get the network transfer a Linode used this month against its quota. Returns an object with billable, quota, used. Use linode_instance_transfer_get to watch transfer usage.
Inputs
linode_idintegerrequired- Linode instance ID, from linode_instances_list. Example: 123456
linode_instance_volumes_listList the Block Storage volumes attached to a Linode.Read-onlyList Linode Volumes
List the Block Storage volumes attached to a Linode. Returns data[] (each with created, encryption, filesystem_path, hardware_type, id, io_ready, label, linode_id) plus page, pages, results. Use linode_instance_volumes_list for one Linode. Use linode_volumes_list for all volumes.
Inputs
linode_idintegerrequired- Linode instance ID, from linode_instances_list. Example: 123456
pageinteger- Page number to return, starting at 1. Example: 1
page_sizeinteger- Results per page, 25 to 500 (default 100). Example: 100
linode_instances_listList the Linode instances you can access, with status, type, region and IPs.Read-onlyList Linodes
List the Linode instances you can access, with status, type, region and IPs. Returns data[] (each with alerts, backups, capabilities, created, disk_encryption, group, has_user_data, host_uuid) plus page, pages, results. Use linode_instances_list to find a Linode ID. Use linode_instance_get for one Linode.
Inputs
pageinteger- Page number to return, starting at 1. Example: 1
page_sizeinteger- Results per page, 25 to 500 (default 100). Example: 100
linode_invoices_listList the account invoices.Read-onlyList Invoices
List the account invoices. Returns data[] (each with billing_source, date, id, label, subtotal, tax, tax_summary, total) plus page, pages, results. Use linode_invoices_list to review billing.
Inputs
pageinteger- Page number to return, starting at 1. Example: 1
page_sizeinteger- Results per page, 25 to 500 (default 100). Example: 100
linode_lke_cluster_getGet one LKE cluster with its version, region and status.Read-onlyGet Kubernetes Cluster
Get one LKE cluster with its version, region and status. Returns an object with apl_enabled, control_plane, created, id, k8s_version, label, region, stack_type, subnet_id, tags, and more. Use linode_lke_cluster_get for one cluster.
Inputs
cluster_idintegerrequired- Cluster ID. Example: 12345
linode_lke_cluster_pools_listList the node pools of an LKE cluster with their node counts and types.Read-onlyList Kubernetes Node Pools
List the node pools of an LKE cluster with their node counts and types. Returns data[] (each with autoscaler, count, disk_encryption, disks, id, k8s_version, label, labels) plus page, pages, results. Use linode_lke_cluster_pools_list to check cluster capacity.
Inputs
cluster_idintegerrequired- Cluster ID. Example: 12345
linode_lke_clusters_listList LKE Kubernetes clusters.Read-onlyList Kubernetes Clusters
List LKE Kubernetes clusters. Returns data[] (each with apl_enabled, control_plane, created, id, k8s_version, label, region, stack_type) plus page, pages, results. Use linode_lke_clusters_list to find a cluster ID.
Inputs
This tool takes no inputs.
linode_nodebalancer_getGet one NodeBalancer with its IPs, region and transfer.Read-onlyGet NodeBalancer
Get one NodeBalancer with its IPs, region and transfer. Returns an object with client_conn_throttle, created, hostname, id, ipv4, ipv6, label, lke_cluster, region, tags, and more. Use linode_nodebalancer_get for one NodeBalancer.
Inputs
node_balancer_idintegerrequired- NodeBalancer ID. Example: 12345
linode_nodebalancers_listList NodeBalancers (load balancers).Read-onlyList NodeBalancers
List NodeBalancers (load balancers). Returns data[] (each with client_conn_throttle, created, hostname, id, ipv4, ipv6, label, lke_cluster) plus page, pages, results. Use linode_nodebalancers_list to find a NodeBalancer.
Inputs
pageinteger- Page number to return, starting at 1. Example: 1
page_sizeinteger- Results per page, 25 to 500 (default 100). Example: 100
linode_profile_getGet the profile of the user who owns the token.Read-onlyGet Profile
Get the profile of the user who owns the token. Returns an object with authentication_type, authorized_keys, email, email_notifications, ip_whitelist_enabled, lish_auth_method, referrals, restricted, timezone, two_factor_auth, and more. Use linode_profile_get to check the connection and see who the token acts as.
Inputs
This tool takes no inputs.
linode_regions_listList the data center regions and the services each offers.Read-onlyList Regions
List the data center regions and the services each offers. Returns data[] (each with capabilities, country, id, label, monitors, placement_group_limits, resolvers, site_type) plus page, pages, results. Use linode_regions_list to pick a region ID for new resources.
Inputs
This tool takes no inputs.
linode_types_listList Linode plan types with CPU, memory, disk, transfer and price.Read-onlyList Linode Plans
List Linode plan types with CPU, memory, disk, transfer and price. Returns data[] (each with addons, class, disk, gpus, id, label, memory, network_out) plus page, pages, results. Use linode_types_list to pick a type ID for linode_instance_create or linode_instance_resize.
Inputs
This tool takes no inputs.
linode_volume_getGet one Block Storage volume with its size, region and attached Linode.Read-onlyGet Volume
Get one Block Storage volume with its size, region and attached Linode. Returns an object with created, encryption, filesystem_path, hardware_type, id, io_ready, label, linode_id, linode_label, region, and more. Use linode_volume_get for one volume.
Inputs
volume_idintegerrequired- Volume ID, from linode_volumes_list. Example: 12345
pageinteger- Page number to return, starting at 1. Example: 1
page_sizeinteger- Results per page, 25 to 500 (default 100). Example: 100
linode_volumes_listList Block Storage volumes.Read-onlyList Volumes
List Block Storage volumes. Returns data[] (each with created, encryption, filesystem_path, hardware_type, id, io_ready, label, linode_id) plus page, pages, results. Use linode_volumes_list to find a volume ID.
Inputs
pageinteger- Page number to return, starting at 1. Example: 1
page_sizeinteger- Results per page, 25 to 500 (default 100). Example: 100
linode_domain_createAdd a domain to the Linode DNS Manager as a master or slave zone.WriteCreate Domain
Add a domain to the Linode DNS Manager as a master or slave zone. Returns an object with axfr_ips, description, domain, expire_sec, group, id, master_ips, refresh_sec, retry_sec, soa_email, and more. Use linode_domain_create to host DNS for a domain on Linode.
Inputs
domainstringrequired- Domain name. Example: example.com
typestringrequired- Zone type. One of: master, slave. Example: masterone of
masterslave axfr_ipsarray- The list of IPs that may perform a zone transfer for this domain. The total combined length of all data within this array cannot exceed 1000 characters. > 📘 > > This is potentially dangerous, and should be set to an empty list unless you intend to use it. Example: ["value"]
descriptionstring- A description for this domain. This is for display purposes only. Example: Short description
expire_secinteger- The amount of time in seconds that may pass before this domain is no longer authoritative. - Valid values are 0, 30, 120, 300, 3600, 7200, 14400, 28800, 57600, 86400, 172800, 345600, 604800, 1209600, and 2419200. - Any other value is rounded up to the nearest valid value. - A value of 0 is equivalent to the default value of 1209600. Example: 300
master_ipsarray- The IP addresses representing the master DNS for this domain. At least one value is required for type slave domains. The total combined length of all data within this array cannot exceed 1000 characters. Example: ["value"]
refresh_secinteger- The amount of time in seconds before this domain should be refreshed. - Valid values are 0, 30, 120, 300, 3600, 7200, 14400, 28800, 57600, 86400, 172800, 345600, 604800, 1209600, and 2419200. - Any other value is rounded up to the nearest valid value. - A value of 0 is equivalent to the default value of 14400. Example: 300
retry_secinteger- The interval, in seconds, at which a failed refresh should be retried. - Valid values are 0, 30, 120, 300, 3600, 7200, 14400, 28800, 57600, 86400, 172800, 345600, 604800, 1209600, and 2419200. - Any other value is rounded up to the nearest valid value. - A value of 0 is equivalent to the default value of 14400. Example: 300
soa_emailstring- SOA contact email; required for master zones. Example: admin@example.com
statusstring- Used to control whether this domain is currently being rendered. One of: disabled, active. Example: activeone of
disabledactive tagsarray- An array of tags applied to this object. Tags are for organizational purposes only. Example: ["example tag", "another example"]
ttl_secinteger- "Time to Live" - the amount of time in seconds that this domain's records may be cached by resolvers or other domain servers. - Valid values are 0, 30, 120, 300, 3600, 7200, 14400, 28800, 57600, 86400, 172800, 345600, 604800, 1209600, and 2419200. - Any other value is rounded up to the nearest valid value. - A value of 0 is equivalent to the default value of 86400. Example: 300
linode_domain_record_createAdd a DNS record (A, AAAA, CNAME, MX, TXT, SRV, CAA, NS) to a domain.WriteCreate DNS Record
Add a DNS record (A, AAAA, CNAME, MX, TXT, SRV, CAA, NS) to a domain. Returns an object with created, id, name, port, priority, protocol, service, tag, target, ttl_sec, and more. Use linode_domain_record_create to point a hostname somewhere.
Inputs
domain_idintegerrequired- Domain ID, from linode_domains_list. Example: 1234
typestringrequired- Record type. One of: A, AAAA, NS, MX, CNAME, TXT, SRV, PTR, CAA. Example: Aone of
AAAAANSMXCNAMETXTSRVPTRCAA namestring- Hostname relative to the domain; empty for the apex. Example: www
portinteger- The port this Record points to. Only valid and required for SRV record requests. Example: 80
priorityinteger- The priority of the target host for this Record. Lower values are preferred. Only valid for MX and SRV record requests. Required for SRV record requests. Defaults to 0 for MX record requests. Must be 0 for Null MX records. Example: 50
protocolstring- The protocol this Record's service communicates with. An underscore (_) is prepended automatically to the submitted value for this property. Only valid for SRV record requests. Example: example
servicestring- The name of the service. An underscore (_) is prepended and a period (.) is appended automatically to the submitted value for this property. Only valid and required for SRV record requests. Example: example
tagstring- The tag portion of a CAA record. Only valid and required for CAA record requests. One of: issue, issuewild, iodef. Example: issueone of
issueissuewildiodef targetstring- Record target, such as an IP address or hostname. Example: 203.0.113.10
ttl_secinteger- "Time to Live" - the amount of time in seconds that this Domain's records may be cached by resolvers or other domain servers. Valid values are 300, 3600, 7200, 14400, 28800, 57600, 86400, 172800, 345600, 604800, 1209600, and 2419200 - any other value will be rounded to the nearest valid value. Example: 604800
weightinteger- The relative weight of this Record used in the case of identical priority. Higher values are preferred. Only valid and required for SRV record requests. Example: 50
linode_domain_record_updateUpdate a DNS record.WriteUpdate DNS Record
Update a DNS record. Returns an object with created, id, name, port, priority, protocol, service, tag, target, ttl_sec, and more. Use linode_domain_record_update to change a record target or TTL.
- Idempotent
Inputs
domain_idintegerrequired- Domain ID, from linode_domains_list. Example: 1234
record_idintegerrequired- Record ID from linode_domain_records_list. Example: 5678
namestring- Hostname relative to the domain. Example: www
portinteger- The port this Record points to. Only valid and required for SRV record requests. Example: {{port}}
priorityinteger- The priority of the target host for this Record. Lower values are preferred. Only valid for MX and SRV record requests. Required for SRV record requests. Defaults to 0 for MX record requests. Must be 0 for Null MX records. Example: {{priority}}
protocolstring- The protocol this Record's service communicates with. An underscore (_) is prepended automatically to the submitted value for this property. Only valid for SRV record requests. Example: {{protocol}}
servicestring- The name of the service. An underscore (_) is prepended and a period (.) is appended automatically to the submitted value for this property. Only valid and required for SRV record requests. Example: {{service}}
tagstring- The tag portion of a CAA record. Only valid and required for CAA record requests. One of: issue, issuewild, iodef. Example: {{tag}}one of
issueissuewildiodef targetstring- Record target. Example: 203.0.113.11
ttl_secinteger- "Time to Live" - the amount of time in seconds that this Domain's records may be cached by resolvers or other domain servers. Valid values are 300, 3600, 7200, 14400, 28800, 57600, 86400, 172800, 345600, 604800, 1209600, and 2419200 - any other value will be rounded to the nearest valid value. Example: {{ttl_sec}}
weightinteger- The relative weight of this Record used in the case of identical priority. Higher values are preferred. Only valid and required for SRV record requests. Example: {{weight}}
linode_domain_updateUpdate a DNS domain settings.WriteUpdate Domain
Update a DNS domain settings. Returns an object with axfr_ips, description, domain, expire_sec, group, id, master_ips, refresh_sec, retry_sec, soa_email, and more. Use linode_domain_update to change SOA, TTLs, status or tags.
- Idempotent
Inputs
domain_idintegerrequired- Domain ID, from linode_domains_list. Example: 1234
axfr_ipsarray- The list of IPs that may perform a zone transfer for this domain. The total combined length of all data within this array cannot exceed 1000 characters. > 📘 > > This is potentially dangerous, and should be set to an empty list unless you intend to use it. Example: ["value"]
descriptionstring- A description for this domain. This is for display purposes only. Example: {{description}}
domainstring- The domain this domain represents. domain labels cannot be longer than 63 characters and must conform to RFC1035. domains must be unique on Linode's platform, including across different Linode accounts; there cannot be two domains representing the same domain. Example: {{domain}}
expire_secinteger- The amount of time in seconds that may pass before this domain is no longer authoritative. - Valid values are 0, 30, 120, 300, 3600, 7200, 14400, 28800, 57600, 86400, 172800, 345600, 604800, 1209600, and 2419200. - Any other value is rounded up to the nearest valid value. - A value of 0 is equivalent to the default value of 1209600. Example: {{expire_sec}}
master_ipsarray- The IP addresses representing the master DNS for this domain. At least one value is required for type slave domains. The total combined length of all data within this array cannot exceed 1000 characters. Example: ["value"]
refresh_secinteger- The amount of time in seconds before this domain should be refreshed. - Valid values are 0, 30, 120, 300, 3600, 7200, 14400, 28800, 57600, 86400, 172800, 345600, 604800, 1209600, and 2419200. - Any other value is rounded up to the nearest valid value. - A value of 0 is equivalent to the default value of 14400. Example: {{refresh_sec}}
retry_secinteger- The interval, in seconds, at which a failed refresh should be retried. - Valid values are 0, 30, 120, 300, 3600, 7200, 14400, 28800, 57600, 86400, 172800, 345600, 604800, 1209600, and 2419200. - Any other value is rounded up to the nearest valid value. - A value of 0 is equivalent to the default value of 14400. Example: {{retry_sec}}
soa_emailstring- Start of Authority email address. This is required for type master domains. Example: {{soa_email}}
statusstring- Used to control whether this domain is currently being rendered. One of: disabled, active. Example: {{status}}one of
disabledactive tagsarray- An array of tags applied to this object. Tags are for organizational purposes only. Example: ["example tag", "another example"]
ttl_secinteger- "Time to Live" - the amount of time in seconds that this domain's records may be cached by resolvers or other domain servers. - Valid values are 0, 30, 120, 300, 3600, 7200, 14400, 28800, 57600, 86400, 172800, 345600, 604800, 1209600, and 2419200. - Any other value is rounded up to the nearest valid value. - A value of 0 is equivalent to the default value of 86400. Example: {{ttl_sec}}
typestring- Whether this domain represents the authoritative source of information for the domain it describes (master), or whether it is a read-only copy of a master (slave). One of: master, slave. Example: {{type}}one of
masterslave
linode_firewall_createCreate a Cloud Firewall with inbound and outbound rules, optionally assigned to Linodes.WriteCreate Firewall
Create a Cloud Firewall with inbound and outbound rules, optionally assigned to Linodes. Returns an object with created, entities, id, label, rules, status, tags, updated. Use linode_firewall_create to protect servers.
Inputs
labelstringrequired- Firewall label. Example: web-fw
rulesobjectrequired- Rules object with inbound and outbound rule lists and inbound_policy/outbound_policy (ACCEPT or DROP). Example: {"inbound_policy": "DROP", "outbound_policy": "ACCEPT", "inbound": [{"action": "ACCEPT", "protocol": "TCP", "ports": "22,80,443", "addresses": {"ipv4": ["0.0.0.0/0"]}}], "outbound": []}
devicesobject- Linodes or NodeBalancers to assign, as {"linodes": [ids], "nodebalancers": [ids]}. Example: {"linodes": [123456]}
tagsarray- An array of tags applied to this object. Tags are for organizational purposes only. Example: ["example tag", "another example"]
linode_firewall_device_createAssign a firewall to a Linode, NodeBalancer or interface.WriteAssign Firewall
Assign a firewall to a Linode, NodeBalancer or interface. Returns an object with created, entity, id, updated. Use linode_firewall_device_create to protect another server with an existing firewall.
Inputs
firewall_idintegerrequired- Firewall ID, from linode_firewalls_list. Example: 1234
idintegerrequired- ID of the Linode, NodeBalancer or interface. Example: 123456
typestringrequired- Device type. One of: linode, nodebalancer, linode_interface. Example: linodeone of
linodenodebalancerlinode_interface
linode_firewall_rules_updateReplace the inbound and outbound rules of a firewall.WriteUpdate Firewall Rules
Replace the inbound and outbound rules of a firewall. Returns an object with fingerprint, inbound, inbound_policy, outbound, outbound_policy, version. Use linode_firewall_rules_update to open or close ports.
- Idempotent
Inputs
firewall_idintegerrequired- Firewall ID, from linode_firewalls_list. Example: 1234
inboundstring- Inbound rules; each has action (ACCEPT or DROP), protocol, ports and addresses. This list replaces the current inbound rules. Example: [{"action": "ACCEPT", "protocol": "TCP", "ports": "22,443", "addresses": {"ipv4": ["0.0.0.0/0"]}, "label": "ssh-https"}]
inbound_policystring- The default behavior for inbound traffic. This setting can be overridden by updating the inbound.action property of the Firewall Rule. One of: ACCEPT, DROP. Example: DROPone of
ACCEPTDROP outboundstring- Outbound rules in the same shape; replaces the current outbound rules. Example: []
outbound_policystring- The default behavior for outbound traffic. This setting can be overridden by updating the outbound.action property of the Firewall Rule. One of: ACCEPT, DROP. Example: ACCEPTone of
ACCEPTDROP
linode_image_createCapture a private image from a Linode disk.WriteCreate Image
Capture a private image from a Linode disk. Returns an object with capabilities, created, created_by, deprecated, description, eol, expiry, id, image_sharing, is_public, and more. Use linode_image_create to save a golden image of a configured server.
Inputs
disk_idintegerrequired- ID of the disk to capture, from linode_instance_disks_list. Example: 123456
cloud_initboolean- Whether this image supports cloud-init. Example: {{cloud_init}}
descriptionstring- A detailed description of this image. Example: {{description}}
labelstring- The short title for this image. If not provided, the disk's current label is used. Example: {{label}}
tagsarray- Tags used for organizational purposes. A tag can be from 3 to 100 characters long, and an image can have a maximum of 500 total tags. Example: ["repair-image", "fix-1"]
linode_instance_bootBoot a Linode that is offline.WriteBoot Linode
Boot a Linode that is offline. Returns the JSON response from the API. Use linode_instance_boot to start a stopped Linode.
- Idempotent
Inputs
linode_idintegerrequired- Linode instance ID, from linode_instances_list. Example: 123456
config_idinteger- The Linode Config ID to boot into. Example: {{config_id}}
linode_instance_cloneClone a Linode disks and configs into a new or existing Linode.WriteClone Linode
Clone a Linode disks and configs into a new or existing Linode. Returns an object with alerts, backups, capabilities, created, disk_encryption, group, has_user_data, host_uuid, hypervisor, id, and more. Use linode_instance_clone to duplicate a server.
Inputs
linode_idintegerrequired- Linode instance ID, from linode_instances_list. Example: 123456
backups_enabledboolean- If this field is set to true, the created Linode will automatically be enrolled in the Linode Backup service. This will incur an additional charge. Pricing is included in the response from List types. - Can only be included when cloning to a new Linode. Example: {{backups_enabled}}
body_linode_idinteger- If an existing Linode is the target for the clone, the ID of that Linode. The existing Linode must have enough resources to accept the clone. Example: {{linode_id}}
configsarray- An array of configuration profile IDs. - If the configs parameter __is not provided__, then __all configuration profiles and their associated disks will be cloned__ from the source Linode. Any disks specified by the disks parameter will also be cloned. - __If an empty array is provided__ for the configs parameter, then __no configuration profiles (nor their associated disks) will be cloned__ from the source Linode. Example: [1, 2]
disksarray- An array of disk IDs. - If the disks parameter __is not provided__, then __no extra disks will be cloned__ from the source Linode. All disks associated with the configuration profiles specified by the configs parameter will still be cloned. - __If an empty array is provided__ for the disks parameter, then __no extra disks will be cloned__ from the source Linode. Example: [1, 2]
labelstring- Label for the new Linode. Example: web-1-clone
maintenance_policystring- Defines the maintenance policy for the new Linode. If you don't provide it, the new Linode inherits the maintenance policy from the original Linode. Review maintenance policy documentation for more details. One of: linode/migrate, linode/power_off_on. Example: {{maintenance_policy}}one of
linode/migratelinode/power_off_on metadataobject- An object containing user-defined data relevant to the creation of Linodes. Example: {"key": "value"}
private_ipboolean- If true, the created Linode will have private networking enabled and assigned a private IPv4 address. - Can only be provided when cloning to a new Linode. Example: {{private_ip}}
regionstring- Region for the new Linode. Example: us-east
typestring- Plan type for the new Linode. Example: g6-standard-1
linode_instance_createCreate a Linode instance in a region with a plan type, optionally from an image with a root password and SSH keys.WriteCreate Linode
Create a Linode instance in a region with a plan type, optionally from an image with a root password and SSH keys. This starts billing. Returns an object with alerts, backups, capabilities, created, disk_encryption, group, has_user_data, host_uuid, hypervisor, id, and more. Use linode_instance_create for a new server. Follow progress with linode_events_list.
Inputs
regionstringrequired- Region ID from linode_regions_list. Example: us-east
typestringrequired- Plan type ID from linode_types_list. Example: g6-nanode-1
authorized_keysarray- SSH public keys to add to root. Example: ["ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAA... user@host"]
backup_idinteger- A Backup ID from another Linode's available backups. Your User must have read_write access to that Linode, the Backup must have a status of successful, and the Linode must be deployed to the same region as the Backup. Run List backups for a Linode's available backups. This field and the image field are mutually exclusive. Example: 1234
backups_enabledboolean- If this field is set to true, the created Linode will automatically be enrolled in the Linode Backup service. This will incur an additional charge. The cost for the Backup service is dependent on the Type of Linode deployed. This option is always treated as true if the account-wide backups_enabled setting is true. See Get account settings for more information. Example: true
bootedboolean- This field defaults to true if the Linode is created with an Image or from a Backup. If it is deployed from an Image or a Backup and you wish it to remain offline after deployment, set this to false. Example: true
disk_encryptionstring- Local disk encryption ensures that your data stored on Linodes is secured. Disk encryption protects against unauthorized data access by keeping the data encrypted if the disk is ever removed from the data center, decommissioned, or disposed of. The platform manages the encryption and decryption for you. By default, encryption is enabled on all Linodes. One of: enabled, disabled. Example: enabledone of
enableddisabled firewall_idinteger- The id of the Firewall to attach this Linode to upon creation. This firewall_id field is for Linodes using VLAN and legacy configuration interfaces only. Example: 12345
imagestring- Image ID from linode_images_list. Example: linode/ubuntu24.04
labelstring- Unique name for the Linode. Example: web-1
maintenance_policystring- Defines the maintenance policy for this Linode. Choose from the following policies: - linode/migrate: Migrates the Linode to a new host while it remains fully operational (with some performance degradation). Recommended for maximizing availability. - linode/power_off_on: Powers off the Linode at the start of the maintenance event and reboots it once the maintenance finishes. Recommended for maximizing performance. One of: linode/migrate, linode/power_off_on. Example: linode/migrateone of
linode/migratelinode/power_off_on network_helperboolean- Enables the Network Helper feature. The default value is determined by the network_helper setting in the account settings. This network_helper field is for Linodes using Linode interfaces only. Example: true
private_ipboolean- If true, the created Linode will have private networking enabled and assigned a private IPv4 address. Example: True
root_passstring- Root password for the new Linode; required when image is set. Use a strong password. Example: Str0ng-Pass!2026
stackscript_idinteger- A StackScript ID that will cause the referenced StackScript to be run during deployment of this Linode. A compatible image is required to use a StackScript. To get a list of available StackScript and their permitted Images, run List StackScripts. This field cannot be used when deploying from a Backup or a Private Image. Example: 10079
swap_sizeinteger- When deploying from an Image, this field is optional, otherwise it is ignored. This is used to set the swap disk size for the newly created Linode. Example: 512
tagsarray- Tags to apply. Example: ["production"]
linode_instance_rebootReboot a Linode.WriteReboot Linode
Reboot a Linode. Returns the JSON response from the API. Use linode_instance_reboot to restart a running Linode.
Inputs
linode_idintegerrequired- Linode instance ID, from linode_instances_list. Example: 123456
config_idinteger- The Linode Config ID to reboot into. If null or omitted, the last booted config will be used. If there was no last booted config and this Linode only has one config, it will be used. If a config cannot be determined, an error will be returned. Example: {{config_id}}
linode_instance_resizeMove a Linode to another plan type.WriteResize Linode
Move a Linode to another plan type. The Linode goes offline during the resize. Returns the JSON response from the API. Use linode_instance_resize to scale a server up or down.
Inputs
linode_idintegerrequired- Linode instance ID, from linode_instances_list. Example: 123456
typestringrequired- Target plan type ID from linode_types_list. Example: g6-standard-2
allow_auto_disk_resizeboolean- Automatically resize disks when resizing a Linode. When resizing down to a smaller plan your Linode's data must fit within the smaller disk size. Example: {{allow_auto_disk_resize}}
migration_typestring- Type of migration used in moving to a new host or Linode type. warm: the Linode will not power down until the migration is complete. Warm migrations are not available for DC migrations. cold: the Linode will be powered down and migrated. When the migration is complete, the Linode will be powered on. One of: warm, cold. Example: {{migration_type}}one of
warmcold
linode_instance_shutdownShut down a Linode (billing continues while it is stopped).WriteShut Down Linode
Shut down a Linode (billing continues while it is stopped). Returns the JSON response from the API. Use linode_instance_shutdown to stop a Linode.
- Idempotent
Inputs
linode_idintegerrequired- Linode instance ID, from linode_instances_list. Example: 123456
linode_instance_snapshot_createTake a manual snapshot backup of a Linode (backups must be enabled).WriteCreate Linode Snapshot
Take a manual snapshot backup of a Linode (backups must be enabled). It replaces the previous snapshot. Returns an object with available, configs, created, disks, finished, id, label, status, type, updated. Use linode_instance_snapshot_create before risky changes.
Inputs
labelstringrequired- Snapshot label. Example: before-upgrade
linode_idintegerrequired- Linode instance ID, from linode_instances_list. Example: 123456
linode_instance_updateUpdate a Linode label, tags, group, alert thresholds or watchdog setting.WriteUpdate Linode
Update a Linode label, tags, group, alert thresholds or watchdog setting. Returns an object with alerts, backups, capabilities, created, disk_encryption, group, has_user_data, host_uuid, hypervisor, id, and more. Use linode_instance_update to rename or retag a Linode. Use linode_instance_resize to change its plan.
- Idempotent
Inputs
linode_idintegerrequired- Linode instance ID, from linode_instances_list. Example: 123456
alertsobject- Alert thresholds to change, such as cpu (percent), io, network_in, network_out and transfer_quota. Example: {"cpu": 90}
labelstring- Provides a name for the Linode. If not provided, the API generates one for it. Linode labels have the following constraints: - It needs to begin and end with an alphanumeric character. - It can only consist of alphanumeric characters, hyphens (-), underscores (_) or periods (.). - Cannot have two hyphens (--), underscores (__) or periods (..) in a row. Example: {{label}}
tagsarray- Tags to help you organize your content. Example: ["example tag", "another example"]
watchdog_enabledboolean- The watchdog, named Lassie, is a Shutdown Watchdog that monitors your Linode and reboots it if it powers off unexpectedly. It works by issuing a boot job when your Linode powers off without a shutdown job being responsible. To prevent a loop, Lassie gives up if there have been more than 5 boot jobs issued within 15 minutes. Example: {{watchdog_enabled}}
linode_volume_attachAttach a volume to a Linode in the same region.WriteAttach Volume
Attach a volume to a Linode in the same region. Returns an object with created, encryption, filesystem_path, hardware_type, id, io_ready, label, linode_id, linode_label, region, and more. Use linode_volume_attach to mount extra storage on a server.
Inputs
linode_idintegerrequired- Linode to attach to. Example: 123456
volume_idintegerrequired- Volume ID, from linode_volumes_list. Example: 12345
config_idinteger- The unique identifier assigned to the Linode configuration where you want to include this volume. Run the List configuration profiles operation and store the id for the target configuration. > 📘 > > - The configuration needs to belong to the Linode referenced by linode_id. > > - If you don't include this value, the API uses the last booted configuration. Example: {{config_id}}
persist_across_bootsboolean- If set to false, the volume won't be attached to the Linode configuration. In this case, more than eight volumes may be attached to a Linode if a Linode has 16GB of RAM or more. The number of volumes you can attach is equal to the number of GB of RAM that the Linode has, up to a maximum of 64. If you set this to false, you can't include a config_id and only the linode_id should be passed. Example: {{persist_across_boots}}
linode_volume_createCreate a Block Storage volume, optionally attached to a Linode.WriteCreate Volume
Create a Block Storage volume, optionally attached to a Linode. This starts billing. Returns an object with created, encryption, filesystem_path, hardware_type, id, io_ready, label, linode_id, linode_label, region, and more. Use linode_volume_create to add storage.
Inputs
labelstringrequired- Volume label. Example: data-1
config_idinteger- When creating a volume attached to a Linode, this is the identifier of the Linode configuration profile (config) where the volume will live. Run the List configuration profiles operation and store the id for the applicable config. The following apply when adding a config_id: - The selected config needs to belong to the Linode referenced by linode_id in this request. Example: {{config_id}}
encryptionstring- Enables encryption on the volume. Full disk encryption ensures the data stored on a block storage volume drive is secure. It protects against unauthorized access by keeping the data encrypted if the volume drive is removed from the data center, decommissioned, or disposed of. The platform automatically manages the encryption and decryption process for you. One of: enabled, disabled. Example: {{encryption}}one of
enableddisabled linode_idinteger- Linode to attach the new volume to. Example: 123456
regionstring- Region ID; required unless linode_id is given. Example: us-east
sizeinteger- Size in GB (10 to 16384, default 20). Example: 20
tagsarray- Any tags applied to this object. Use tags to label and organize your cloud computing resources. Example: ["example tag", "another example"]
linode_volume_detachDetach a volume from its Linode.WriteDetach Volume
Detach a volume from its Linode. Returns the JSON response from the API. Use linode_volume_detach before moving or deleting a volume.
- Idempotent
Inputs
volume_idintegerrequired- Volume ID, from linode_volumes_list. Example: 12345
linode_volume_resizeGrow a volume to a larger size (volumes cannot shrink).WriteResize Volume
Grow a volume to a larger size (volumes cannot shrink). Returns an object with created, encryption, filesystem_path, hardware_type, id, io_ready, label, linode_id, linode_label, region, and more. Use linode_volume_resize to add space.
Inputs
sizeintegerrequired- New size in GB, larger than the current size. Example: 40
volume_idintegerrequired- Volume ID, from linode_volumes_list. Example: 12345
linode_domain_deleteDelete a domain and all its records from the DNS Manager.DestructiveDelete Domain
Delete a domain and all its records from the DNS Manager. Returns the JSON response from the API. Use linode_domain_delete only to stop hosting DNS for a domain.
- Idempotent
Inputs
domain_idintegerrequired- Domain ID, from linode_domains_list. Example: 1234
linode_domain_record_deleteDelete a DNS record.DestructiveDelete DNS Record
Delete a DNS record. Returns the JSON response from the API. Use linode_domain_record_delete to remove a record.
- Idempotent
Inputs
domain_idintegerrequired- Domain ID, from linode_domains_list. Example: 1234
record_idintegerrequired- Record ID. Example: 5678
linode_firewall_deleteDelete a firewall and remove it from all its devices.DestructiveDelete Firewall
Delete a firewall and remove it from all its devices. Returns the JSON response from the API. Use linode_firewall_delete to remove a firewall for good.
- Idempotent
Inputs
firewall_idintegerrequired- Firewall ID, from linode_firewalls_list. Example: 1234
linode_image_deleteDelete a private image.DestructiveDelete Image
Delete a private image. Returns the JSON response from the API. Use linode_image_delete to remove an image you no longer need.
- Idempotent
Inputs
image_idstringrequired- Private image ID. Example: private/12345
linode_instance_deleteDelete a Linode instance with its disks and backups.DestructiveDelete Linode
Delete a Linode instance with its disks and backups. This cannot be undone. Returns the JSON response from the API. Use linode_instance_delete only to destroy a server for good.
- Idempotent
Inputs
linode_idintegerrequired- Linode instance ID, from linode_instances_list. Example: 123456
linode_instance_rebuildRebuild a Linode from an image, wiping its disks.DestructiveRebuild Linode
Rebuild a Linode from an image, wiping its disks. Returns an object with alerts, backups, capabilities, created, disk_encryption, group, has_user_data, host_uuid, hypervisor, id, and more. Use linode_instance_rebuild to reinstall the operating system. This erases all data on the Linode.
Inputs
imagestringrequired- Image ID to rebuild from. Example: linode/ubuntu24.04
linode_idintegerrequired- Linode instance ID, from linode_instances_list. Example: 123456
root_passstringrequired- New root password. Example: Str0ng-Pass!2026
authorized_keysarray- A list of public SSH keys that will be automatically appended to the root user's ~/.ssh/authorized_keys file when deploying from an Image. Example: ["ssh-rsa AAAA_valid_public_ssh_key_123456785== user@their-computer"]
bootedboolean- This field defaults to true if the Linode is created with an Image or from a Backup. If it is deployed from an Image or a Backup and you wish it to remain offline after deployment, set this to false. Example: true
disk_encryptionstring- Local disk encryption ensures that your data stored on Linodes is secured. Disk encryption protects against unauthorized data access by keeping the data encrypted if the disk is ever removed from the data center, decommissioned, or disposed of. The platform manages the encryption and decryption for you. By default, encryption is enabled on all Linodes. One of: enabled, disabled. Example: enabledone of
enableddisabled maintenance_policystring- Defines the maintenance policy for this Linode. Choose from the following policies: - linode/migrate: Migrates the Linode to a new host while it remains fully operational (with some performance degradation). Recommended for maximizing availability. - linode/power_off_on: Powers off the Linode at the start of the maintenance event and reboots it once the maintenance finishes. Recommended for maximizing performance. One of: linode/migrate, linode/power_off_on. Example: linode/migrateone of
linode/migratelinode/power_off_on stackscript_idinteger- A StackScript ID that will cause the referenced StackScript to be run during deployment of this Linode. A compatible image is required to use a StackScript. To get a list of available StackScript and their permitted Images, run List StackScripts. This field cannot be used when deploying from a Backup or a Private Image. Example: 10079
typestring- The ID of the Linode type to resize to with this request. Example: g6-standard-2
linode_volume_deleteDelete a detached volume and its data.DestructiveDelete Volume
Delete a detached volume and its data. Returns the JSON response from the API. Use linode_volume_delete only to destroy a volume for good.
- Idempotent
Inputs
volume_idintegerrequired- Volume ID, from linode_volumes_list. Example: 12345
No tools match.