> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fly.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Destroy Volume

> Delete a specific volume within an app by volume ID.




## OpenAPI

````yaml /api/machines/openapi.json delete /v1/apps/{app_name}/volumes/{volume_id}
openapi: 3.1.0
info:
  title: Machines API
  description: >-
    This site hosts documentation generated from the Fly.io Machines API OpenAPI
    specification. Visit our complete [Machines API
    docs](https://fly.io/docs/machines/api/) for how to get started, more
    information about each endpoint, parameter descriptions, and examples.
  contact: {}
  license:
    name: Apache 2.0
    url: http://www.apache.org/licenses/LICENSE-2.0.html
  version: '1.0'
servers:
  - url: https://api.machines.dev
security:
  - FlyBearerAuth: []
tags:
  - name: Apps
    description: >-
      This site hosts documentation generated from the Fly.io Machines API
      OpenAPI specification. Visit our complete [Machines API
      docs](https://fly.io/docs/machines/api/apps-resource/) for details about
      using the Apps resource.
  - name: Machines
    description: >-
      This site hosts documentation generated from the Fly.io Machines API
      OpenAPI specification. Visit our complete [Machines API
      docs](https://fly.io/docs/machines/api/machines-resource/) for details
      about using the Machines resource.
  - name: TLS Certificates
    description: >
      This site hosts documentation generated from the Fly.io Machines API
      OpenAPI specification. Visit our complete [Machines API
      docs](https://fly.io/docs/machines/api/certificates-resource/) for details
      about using the TLS Certificates resource.
  - name: Volumes
    description: >-
      This site hosts documentation generated from the Fly.io Machines API
      OpenAPI specification. Visit our complete [Machines API
      docs](https://fly.io/docs/machines/api/volumes-resource/) for details
      about using the Volumes resource.
  - name: Postgres Clusters
    description: >-
      Create and manage Postgres clusters, including databases, users,
      extensions, backups, and app attachments.
externalDocs:
  url: https://fly.io/docs/machines/working-with-machines/
paths:
  /v1/apps/{app_name}/volumes/{volume_id}:
    delete:
      tags:
        - Volumes
      summary: Destroy Volume
      description: |
        Delete a specific volume within an app by volume ID.
      operationId: Volume_delete
      parameters:
        - name: app_name
          in: path
          description: Fly App Name
          required: true
          schema:
            type: string
        - name: volume_id
          in: path
          description: Volume ID
          required: true
          schema:
            type: string
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Volume'
components:
  schemas:
    Volume:
      type: object
      properties:
        attached_alloc_id:
          type: string
          description: |-
            Always null.

            Deprecated: volumes are no longer attached to Nomad allocations.
        attached_machine_id:
          type: string
          description: >-
            ID of the Machine the volume is attached to, or null if it is not
            attached.
        auto_backup_enabled:
          type: boolean
          description: Whether daily automatic snapshots are taken.
        block_size:
          type: integer
          description: Size of a filesystem block, in bytes. See `blocks`.
        blocks:
          type: integer
          description: >-
            Size of the volume's filesystem, in blocks of `block_size` bytes, as
            last reported by a

            Machine that mounted the volume. 0 if never reported, if the host
            could not be reached,

            or with `summary=true`.
        blocks_avail:
          type: integer
          description: >-
            Number of filesystem blocks available to unprivileged users. See
            `blocks`.
        blocks_free:
          type: integer
          description: >-
            Number of free filesystem blocks, including blocks reserved for the
            root user. See

            `blocks`.
        bytes_total:
          type: integer
          description: >-
            Size of the volume, in bytes. 0 if the host could not be reached or
            with `summary=true`.
        bytes_used:
          type: integer
          description: >-
            Bytes of storage the volume occupies on its host. Volumes are thinly
            provisioned, so this

            grows as blocks are written and does not shrink when files are
            deleted. It is not the

            filesystem's usage; use `blocks` and `blocks_free` for that. 0 if
            the host could not be

            reached or with `summary=true`.
        created_at:
          type: string
          description: When the volume was created.
        encrypted:
          type: boolean
          description: Whether the volume is encrypted at rest.
        fstype:
          type: string
          description: >-
            Filesystem the volume was formatted with: `ext4`, or `raw` for an
            unformatted block

            device.
        host_features:
          type: array
          description: >-
            Features of the volume's host. Only returned when the request sets
            the

            `fly-include-host-features: true` header.
          items:
            type: string
        host_status:
          type: string
          description: >-
            Whether Fly.io could reach the volume's host: `ok` if it could,
            `unreachable` or

            `unknown` if it could not, in which case host-reported fields are
            missing.
          enum:
            - ok
            - unknown
            - unreachable
        id:
          type: string
          description: Unique ID of the volume, such as `vol_1234567890abcdef`.
        name:
          type: string
          description: Name of the volume. Several volumes of an app can share a name.
        region:
          type: string
          description: Code of the region the volume is in.
        required_host_features:
          type: array
          description: >-
            Host features the volume's host was required to have; see
            `compute.required_host_features`

            in the create request.
          items:
            type: string
        size_gb:
          type: integer
          description: Size of the volume, in GiB.
        snapshot_retention:
          type: integer
          description: Number of days snapshots of the volume are kept.
        state:
          type: string
          description: >-
            State of the volume, such as `creating`, `created`, `extending`,
            `restoring`,

            `hydrating`, `scheduling_destroy`, `pending_destroy`, `destroying`,
            `destroyed`, or

            `failed`.
        type:
          type: string
          description: >-
            Kind of volume: `local` for regular volumes, or `cache` for volumes
            that hold

            disposable data and support neither snapshots nor restores.
          enum:
            - local
            - cache
        zone:
          type: string
          description: >-
            Identifies the host the volume is on. Volumes with different zones
            are on different

            hosts.
  securitySchemes:
    FlyBearerAuth:
      type: http
      scheme: bearer
      description: >-
        A Fly API token with access to the requested organization or resource.
        Send it as `Authorization: Bearer <Fly API token>`.

````