> ## Documentation Index > Fetch the complete documentation index at: https://www.latitude.sh/docs/llms.txt > Use this file to discover all available pages before exploring further. # Update VM > Updates a Virtual Machine's display name (hostname). ## OpenAPI ````yaml https://spec.speakeasy.com/latitude/latitude/latitude-sh-api-with-code-samples patch /virtual_machines/{virtual_machine_id} openapi: 3.0.1 info: title: Latitude.sh API version: '2023-06-01' description: >- The Latitude.sh API is a RESTful API to manage your Latitude.sh account. It allows you to perform the same actions as the Latitude.sh dashboard. servers: - url: https://api.latitude.sh variables: latitude_api_key: default: - url: http://api.latitude.sh variables: latitude_api_key: default: security: [] tags: - name: API keys - name: Billing - name: Elastic Ips - name: Events - name: Firewalls - name: IP Addresses - name: Kubernetes Clusters - name: Operating Systems - name: Plans - name: Private Networks - name: Projects - name: Regions - name: Roles - name: SSH Keys - name: Servers - name: Storage - name: Tags - name: Teams - name: Team members - name: Traffic - name: User data - name: User profile - name: VPN Sessions - name: Virtual machines paths: /virtual_machines/{virtual_machine_id}: patch: tags: - Virtual machines summary: Update VM description: | Updates a Virtual Machine's display name (hostname). operationId: update-virtual-machine parameters: - name: virtual_machine_id in: path required: true examples: Success: value: vm_7vYAZqGBdMQ94 schema: type: string requestBody: content: application/json: schema: $ref: '#/components/schemas/virtual_machine_update_payload' examples: Success: summary: Success value: data: type: virtual_machines id: vm_7vYAZqGBdMQ94 attributes: name: my-updated-vm application/vnd.api+json: schema: $ref: '#/components/schemas/virtual_machine_update_payload' examples: Success: summary: Success value: data: type: virtual_machines id: vm_7vYAZqGBdMQ94 attributes: name: my-updated-vm required: true responses: '200': description: Success content: application/vnd.api+json: examples: Success: value: data: id: vm_7vYAZqGBdMQ94 type: virtual_machines attributes: name: my-updated-vm status: Running created_at: '2026-01-14T15:57:15+00:00' primary_ipv4: 10.0.0.25 operating_system: null site: london-2193 billing: hourly plan: id: plan_VE1Wd3VQOXnZJ name: c3.small.x86-143 specs: vcpu: 16 ram: 128 GB storage: 100 GB nic: 1 x 1 Gbps gpu: 1 x NVIDIA H100 Tensor Core GPU team: id: team_GpZboxNev1U2pxpmKwWAc8e01vpp name: 702 Team slug: 702-team description: 702 Team address: >- Suite 729 8171 Albina Forges, Eldridgeberg, CA 26345-3293 status: verified currency: id: cur_AW6Q2D9lqKLpr code: BRL name: Brazilian Real currency_id: null project: id: proj_W6Q2D9ZQOKLpr name: Aerodynamic Wool Watch slug: aerodynamic-wool-watch description: Intelligent Paper Shirt billing_type: Normal billing_method: Normal bandwidth_alert: false environment: null billing: subscription_id: null type: Normal method: Normal stats: databases: 0 ip_addresses: 0 prefixes: 0 servers: 0 storages: 0 virtual_machines: 1 vlans: 0 schema: $ref: '#/components/schemas/virtual_machine' '404': description: Not Found '422': description: Unprocessable Entity security: - Bearer: [] x-codeSamples: - lang: python label: Python (SDK) source: |- import latitudesh_python_sdk from latitudesh_python_sdk import Latitudesh import os with Latitudesh( bearer=os.getenv("LATITUDESH_BEARER", ""), ) as latitudesh: res = latitudesh.virtual_machines.update_virtual_machine(virtual_machine_id="vm_7vYAZqGBdMQ94", data={ "type": latitudesh_python_sdk.VirtualMachineUpdatePayloadType.VIRTUAL_MACHINES, "id": "vm_7vYAZqGBdMQ94", "attributes": { "name": "my-updated-vm", }, }) # Handle response print(res) - lang: go label: Go (SDK) source: "package main\n\nimport(\n\t\"context\"\n\t\"os\"\n\tlatitudeshgosdk \"github.com/latitudesh/latitudesh-go-sdk\"\n\t\"github.com/latitudesh/latitudesh-go-sdk/models/components\"\n\t\"log\"\n)\n\nfunc main() {\n ctx := context.Background()\n\n s := latitudeshgosdk.New(\n latitudeshgosdk.WithSecurity(os.Getenv(\"LATITUDESH_BEARER\")),\n )\n\n res, err := s.VirtualMachines.UpdateVirtualMachine(ctx, \"vm_7vYAZqGBdMQ94\", components.VirtualMachineUpdatePayload{\n Data: components.VirtualMachineUpdatePayloadData{\n Type: components.VirtualMachineUpdatePayloadTypeVirtualMachines,\n ID: latitudeshgosdk.Pointer(\"vm_7vYAZqGBdMQ94\"),\n Attributes: components.VirtualMachineUpdatePayloadAttributes{\n Name: \"my-updated-vm\",\n },\n },\n })\n if err != nil {\n log.Fatal(err)\n }\n if res.VirtualMachine != nil {\n // handle response\n }\n}" - lang: typescript label: Typescript (SDK) source: |- import { Latitudesh } from "latitudesh-typescript-sdk"; const latitudesh = new Latitudesh({ bearer: process.env["LATITUDESH_BEARER"] ?? "", }); async function run() { const result = await latitudesh.virtualMachines.updateVirtualMachine({ virtualMachineId: "vm_7vYAZqGBdMQ94", virtualMachineUpdatePayload: { data: { type: "virtual_machines", id: "vm_7vYAZqGBdMQ94", attributes: { name: "my-updated-vm", }, }, }, }); console.log(result); } run(); components: schemas: virtual_machine_update_payload: type: object properties: data: type: object properties: type: type: string enum: - virtual_machines id: type: string attributes: type: object properties: name: type: string description: The new display name (hostname) for the Virtual Machine required: - name required: - type - attributes required: - data virtual_machine: type: object properties: data: $ref: '#/components/schemas/virtual_machine_attributes' meta: type: object virtual_machine_attributes: type: object properties: id: type: string type: type: string enum: - virtual_machines attributes: type: object properties: name: type: string created_at: type: string status: type: string enum: - Running - Configuring network - Starting - Scheduling - Scheduled - Destroying primary_ipv4: type: string nullable: true operating_system: type: object nullable: true description: The operating system installed on the virtual machine properties: name: type: string description: The full name of the operating system slug: type: string description: The unique slug identifier for the operating system version: type: string description: The version of the operating system features: type: object description: Features supported by this operating system properties: raid: type: boolean description: Whether RAID is supported ssh_keys: type: boolean description: Whether SSH keys are supported user_data: type: boolean description: Whether user data is supported distro: type: object description: Distribution information properties: name: type: string description: The name of the Linux distribution slug: type: string description: The slug of the Linux distribution series: type: string description: The distribution series code name credentials: type: object nullable: true properties: username: type: string host: type: string password: type: string ssh_keys: type: array items: type: string plan: type: object properties: id: type: string name: type: string specs: type: object properties: vcpu: type: integer nullable: true ram: type: string nullable: true storage: type: string nullable: true nic: type: string nullable: true gpu: type: string nullable: true team: $ref: '#/components/schemas/team_include' project: $ref: '#/components/schemas/project_include' team_include: type: object properties: id: type: string name: type: string slug: type: string description: type: string nullable: true address: type: string currency: type: object status: type: string feature_flags: type: array items: type: string project_include: type: object properties: id: type: string name: type: string slug: type: string description: type: string nullable: true billing_type: type: string nullable: true provisioning_type: type: string nullable: true billing_method: type: string nullable: true bandwidth_alert: type: boolean environment: type: string nullable: true billing: type: object properties: subscription_id: type: string nullable: true type: type: string method: type: string stats: type: object properties: ip_addresses: type: integer prefixes: type: integer servers: type: integer vlans: type: integer securitySchemes: Bearer: type: apiKey name: Authorization in: header ````