---
title: Delete Chat Version Files
description: Deletes source files from a specific chat version (block). Files are removed from the version and a new source version is created.
product: Platform API
type: reference
prerequisites:
  - /docs/api/platform/quickstart
---

# Delete Chat Version Files



<EndpointDisplay method="post" path="/chats/{chatId}/versions/{versionId}/files/delete" />

## Usage [#usage]

<CustomCodeBlock languages="['TypeScript', 'cURL']" defaultLanguage="TypeScript">
  <CodeVariant
    language="TypeScript"
    title="TypeScript Example"
    code="`import { v0 } from 'v0-sdk'

const result = await v0.chats.deleteVersionFiles({
  chatId: 'chat_abc123',
  versionId: 'version_xyz789',
  filePaths: ['components/old-component.tsx', 'lib/unused-utils.ts'],
})

console.log(result)`"
  />

  <CodeVariant
    language="cURL"
    title="cURL Example"
    code="`curl -X POST https://api.v0.dev/chats/{chatId}/versions/{versionId}/files/delete \\
  -H &#x22;Authorization: Bearer $V0_API_KEY&#x22; \\
  -H &#x22;Content-Type: application/json&#x22; \\
  -d '{&#x22;filePaths&#x22;: [&#x22;components/old-component.tsx&#x22;, &#x22;lib/unused-utils.ts&#x22;]}'`"
  />
</CustomCodeBlock>

## API Signature [#api-signature]

### Request [#request]

#### Path Parameters [#path-parameters]

<APISignature
  parameters="[
  {
    &#x22;name&#x22;: &#x22;chatId&#x22;,
    &#x22;type&#x22;: &#x22;string&#x22;,
    &#x22;required&#x22;: true,
    &#x22;description&#x22;: &#x22;The unique identifier of the chat containing the version to delete files from.&#x22;
  },
  {
    &#x22;name&#x22;: &#x22;versionId&#x22;,
    &#x22;type&#x22;: &#x22;string&#x22;,
    &#x22;required&#x22;: true,
    &#x22;description&#x22;: &#x22;The unique identifier of the version (block) to delete files from.&#x22;
  }
]"
/>

#### Body [#body]

<APISignature
  parameters="[
  {
    &#x22;name&#x22;: &#x22;filePaths&#x22;,
    &#x22;type&#x22;: &#x22;string[]&#x22;,
    &#x22;required&#x22;: true,
    &#x22;description&#x22;: &#x22;Array of file paths to delete (e.g., [\&#x22;components/test.tsx\&#x22;, \&#x22;lib/utils.ts\&#x22;]). Must contain at least one file path.&#x22;,
    &#x22;deprecated&#x22;: false
  }
]"
/>

### Response [#response]

<APISignature
  parameters="[
  {
    &#x22;name&#x22;: &#x22;id&#x22;,
    &#x22;type&#x22;: &#x22;string&#x22;,
    &#x22;required&#x22;: true,
    &#x22;description&#x22;: &#x22;A unique identifier for the version.&#x22;,
    &#x22;deprecated&#x22;: false
  },
  {
    &#x22;name&#x22;: &#x22;object&#x22;,
    &#x22;type&#x22;: &#x22;'version'&#x22;,
    &#x22;required&#x22;: true,
    &#x22;description&#x22;: &#x22;Fixed value identifying this object as a version.&#x22;,
    &#x22;deprecated&#x22;: false
  },
  {
    &#x22;name&#x22;: &#x22;status&#x22;,
    &#x22;type&#x22;: &#x22;'pending' | 'completed' | 'failed'&#x22;,
    &#x22;required&#x22;: true,
    &#x22;description&#x22;: &#x22;The current status of the version generation process.&#x22;,
    &#x22;deprecated&#x22;: false
  },
  {
    &#x22;name&#x22;: &#x22;demoUrl&#x22;,
    &#x22;type&#x22;: &#x22;string&#x22;,
    &#x22;required&#x22;: false,
    &#x22;description&#x22;: &#x22;Optional URL for previewing the generated output.&#x22;,
    &#x22;deprecated&#x22;: false
  },
  {
    &#x22;name&#x22;: &#x22;screenshotUrl&#x22;,
    &#x22;type&#x22;: &#x22;string&#x22;,
    &#x22;required&#x22;: false,
    &#x22;description&#x22;: &#x22;An authenticated URL to retrieve a screenshot of this version. Fetching this URL requires the same Authorization: Bearer header as all other API calls — it cannot be used directly as an `<img>` `src`. To display it in a browser, proxy the request server-side and forward the Authorization header. Append `?ignoreCache=1` to bypass the one-week screenshot cache.&#x22;,
    &#x22;deprecated&#x22;: false
  },
  {
    &#x22;name&#x22;: &#x22;createdAt&#x22;,
    &#x22;type&#x22;: &#x22;string&#x22;,
    &#x22;required&#x22;: true,
    &#x22;description&#x22;: &#x22;The date and time when the version was created, in ISO 8601 format.&#x22;,
    &#x22;deprecated&#x22;: false
  },
  {
    &#x22;name&#x22;: &#x22;updatedAt&#x22;,
    &#x22;type&#x22;: &#x22;string&#x22;,
    &#x22;required&#x22;: false,
    &#x22;description&#x22;: &#x22;The date and time when the version was last updated, in ISO 8601 format.&#x22;,
    &#x22;deprecated&#x22;: false
  },
  {
    &#x22;name&#x22;: &#x22;files&#x22;,
    &#x22;type&#x22;: &#x22;object[]&#x22;,
    &#x22;required&#x22;: true,
    &#x22;description&#x22;: &#x22;A list of files that remain in this version after deletion.&#x22;,
    &#x22;deprecated&#x22;: false,
    &#x22;arrayItems&#x22;: {
      &#x22;name&#x22;: &#x22;item&#x22;,
      &#x22;type&#x22;: &#x22;object&#x22;,
      &#x22;required&#x22;: true,
      &#x22;description&#x22;: &#x22;Detailed representation of a file, including its content and lock status.&#x22;,
      &#x22;deprecated&#x22;: false,
      &#x22;properties&#x22;: [
        {
          &#x22;name&#x22;: &#x22;object&#x22;,
          &#x22;type&#x22;: &#x22;'file'&#x22;,
          &#x22;required&#x22;: true,
          &#x22;description&#x22;: &#x22;Fixed value identifying this object as a file.&#x22;,
          &#x22;deprecated&#x22;: false
        },
        {
          &#x22;name&#x22;: &#x22;name&#x22;,
          &#x22;type&#x22;: &#x22;string&#x22;,
          &#x22;required&#x22;: true,
          &#x22;description&#x22;: &#x22;The name of the file, including its extension.&#x22;,
          &#x22;deprecated&#x22;: false
        },
        {
          &#x22;name&#x22;: &#x22;content&#x22;,
          &#x22;type&#x22;: &#x22;string&#x22;,
          &#x22;required&#x22;: true,
          &#x22;description&#x22;: &#x22;The full contents of the file as a raw string.&#x22;,
          &#x22;deprecated&#x22;: false
        },
        {
          &#x22;name&#x22;: &#x22;locked&#x22;,
          &#x22;type&#x22;: &#x22;boolean&#x22;,
          &#x22;required&#x22;: true,
          &#x22;description&#x22;: &#x22;Whether the file is locked to prevent AI from overwriting it during new version generation.&#x22;,
          &#x22;deprecated&#x22;: false
        }
      ]
    }
  }
]"
/>