> ## 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 volume > Increases the size of a high performance volume. Shrinking is not supported. Billing is prorated to the new size. ## OpenAPI ````yaml https://spec.speakeasy.com/latitude/latitude/latitude-sh-api-with-code-samples patch /storage/volumes/{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: Baselines (Preview) description: >- Preview. Available to teams with the `baselines_api` feature flag. The shape of these endpoints may change before general availability. - name: Billing - name: Elastic Ips - name: Events - name: Firewalls - name: Inference - name: IP Addresses - name: Managed Databases description: Managed database instances (PostgreSQL, ClickHouse) - name: Kubernetes Clusters - name: LKS - name: Marketplace apps - name: Operating Systems - name: Plans - name: Sandboxes (Preview) description: >- Preview. Available to teams with the `sandboxes_api` feature flag. The shape of these endpoints may change before general availability. - name: Public Networks - name: Private Networks - name: Projects - name: Regions - name: Roles - name: SSH Keys - name: Servers - name: Block Storage - name: Filesystem Storage - name: Object Storage - name: Tags - name: Teams - name: Team members - name: Traffic - name: User data - name: User profile - name: VPN Sessions - name: Virtual machines - name: Virtual machine backups - name: Virtual machine restores paths: /storage/volumes/{id}: patch: tags: - Block Storage summary: Update volume description: >- Increases the size of a high performance volume. Shrinking is not supported. Billing is prorated to the new size. operationId: update-volume parameters: - name: id in: path required: true description: Volume ID schema: type: string requestBody: content: application/json: schema: type: object properties: data: type: object properties: type: type: string enum: - volumes attributes: type: object properties: size_in_gb: type: integer minimum: 1 maximum: 30720 description: >- New size in GB. Must be larger than the current size. required: - size_in_gb required: - type - attributes required: - data application/vnd.api+json: schema: type: object properties: data: type: object properties: type: type: string enum: - volumes attributes: type: object properties: size_in_gb: type: integer minimum: 1 maximum: 30720 description: >- New size in GB. Must be larger than the current size. required: - size_in_gb required: - type - attributes required: - data required: true responses: '200': description: Success content: application/vnd.api+json: schema: type: object properties: data: $ref: '#/components/schemas/volume_data' meta: type: object 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.block_storage.update_volume(id="", data={ "type": latitudesh_python_sdk.UpdateVolumeBlockStorageType.VOLUMES, "attributes": { "size_in_gb": 873925, }, }) # 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/operations\"\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.BlockStorage.UpdateVolume(ctx, \"\", operations.UpdateVolumeBlockStorageRequestBody{\n Data: operations.UpdateVolumeBlockStorageData{\n Type: operations.UpdateVolumeBlockStorageTypeVolumes,\n Attributes: operations.UpdateVolumeBlockStorageAttributes{\n SizeInGb: 873925,\n },\n },\n })\n if err != nil {\n log.Fatal(err)\n }\n if res.Object != 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.blockStorage.updateVolume({ id: "", requestBody: { data: { type: "volumes", attributes: { sizeInGb: 873925, }, }, }, }); console.log(result); } run(); components: schemas: volume_data: type: object properties: id: type: string type: type: string enum: - volumes attributes: type: object properties: name: type: string size_in_gb: type: integer created_at: type: string format: date-time nullable: true namespace_id: type: integer nullable: true connector_id: type: string nullable: true initiators: type: array items: type: object properties: nqn: type: string nullable: true nguid: type: string nullable: true description: >- NVMe namespace globally unique identifier (NGUID) of the volume, exactly as reported by the storage cluster, in UUID form (e.g. "b338cb51-7593-413d-8c87-2657af7ecae9"). Without the dashes it matches the NGUID the mapped server reports for the NVMe device of the volume. Null when it has not been recorded for the volume. block: type: object nullable: true description: >- NVMe-TCP block mappings of a high performance volume. A volume can be mapped to several servers at once; every server writes to the same NVMe namespace, so use a cluster-aware filesystem when more than one server mounts the volume. Null for volumes that are not mapped to any server. properties: status: type: string nullable: true deprecated: true description: >- Deprecated: use mappings[].status. Status of the mapping when the volume is mapped to exactly one server; null otherwise. nqn: type: string nullable: true deprecated: true description: >- Deprecated: use mappings[].nqn. NVMe Qualified Name of the server when the volume is mapped to exactly one server; null otherwise. nsid: type: integer nullable: true deprecated: true description: >- Deprecated: use mappings[].nsid. NVMe namespace ID of the mapping when the volume is mapped to exactly one server; null otherwise. server_id: type: string nullable: true deprecated: true description: >- Deprecated: use mappings[].server_id. ID of the server when the volume is mapped to exactly one server; null otherwise. mappings: type: array description: One entry per server the volume is mapped to. items: type: object properties: server_id: type: string nullable: true description: ID of the mapped server. status: type: string nullable: true description: >- Mapping lifecycle state: "mapping" while the mapping is being applied, "mapped" once the server can access the volume, "unmapping" while the mapping is being removed, or "failed". Mapping and unmapping are asynchronous, so poll the volume until this reaches a terminal state. The entry disappears once the server is fully unmapped. nqn: type: string nullable: true description: NVMe Qualified Name of the server. nsid: type: integer nullable: true description: NVMe namespace ID of the mapping. host_cidr: type: string nullable: true description: >- Storage IP of the server, in CIDR notation. Null until the mapping status is "mapped". storage_network: type: object nullable: true description: >- Storage network the mapped servers join to reach the volume over NVMe-TCP. Null until the network has been provisioned for the volume. properties: vid: type: integer nullable: true description: VLAN ID of the storage VLAN to tag on the server bond. host_cidr: type: string nullable: true deprecated: true description: >- Deprecated: use mappings[].host_cidr. Storage IP of the server when the volume is mapped to exactly one server and the mapping is "mapped"; null otherwise. gateway: type: string nullable: true description: >- Gateway of the storage network, used for the routes below. routes: type: array items: type: string nullable: true description: >- Storage infrastructure prefixes to route via the gateway. block_gateway: type: string nullable: true description: NVMe-oF/TCP discovery portal address. block_port: type: integer nullable: true description: NVMe-oF/TCP discovery portal port. keyring: type: string nullable: true description: >- Keyring secret used to connect to the volume. Returned only for dashboard-origin requests; null until the volume is provisioned. cluster_user: type: string nullable: true description: >- Cluster user used to connect to the volume. Returned only for dashboard-origin requests; null until the volume is provisioned. volume_path: type: string nullable: true description: >- Path of the volume inside the cluster. Returned only for dashboard-origin requests; null until the volume is provisioned. region: type: object nullable: true properties: city: type: string nullable: true country: type: string nullable: true site: type: object nullable: true properties: id: type: string name: type: string slug: type: string facility: type: string project: $ref: '#/components/schemas/project_include' team: $ref: '#/components/schemas/team_include' 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: databases: type: integer ip_addresses: type: integer prefixes: type: integer servers: type: integer storages: type: integer virtual_machines: type: integer vlans: type: integer team_include: type: object properties: id: type: string name: type: string slug: type: string description: type: string nullable: true address: type: string nullable: true currency: type: object properties: id: type: string code: type: string name: type: string currency_id: type: integer nullable: true status: type: string nullable: true feature_flags: type: array items: type: string limits: type: object properties: bare_metal: type: integer nullable: true bare_metal_gpu: type: integer nullable: true virtual_machine: type: integer nullable: true virtual_machine_gpu: type: integer nullable: true elastic_ip: type: integer nullable: true bgp_session_per_ip: type: integer nullable: true public_network: type: integer nullable: true virtual_network: type: integer nullable: true database: type: integer nullable: true filesystem: type: integer nullable: true block_storage: type: integer nullable: true securitySchemes: Bearer: type: apiKey name: Authorization in: header ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.