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

# Delete Upload

> Delete an uploaded file

> **For AI agents:** a documentation index is at [/llms.txt](/llms.txt). Every page is also available as markdown, just append `.md` to the URL.

## Overview

Permanently delete an uploaded file from storage. This action cannot be undone.

## Rate Limiting

This endpoint is rate limited to 10 requests per minute per API key.

<Note>
  This permanently removes the file from storage. Any projects that reference this upload will not be affected, but the original source file will no longer be available.
</Note>

## Response

<ResponseField name="uploadId" type="string">
  ID of the deleted upload
</ResponseField>

<ResponseField name="deleted" type="boolean">
  Always `true` on success
</ResponseField>

## Example Request

<CodeGroup>
  ```bash cURL theme={"system"}
  curl -X DELETE "https://public.reap.video/api/v1/automation/delete-upload?uploadId=65f1a2b3c4d5e6f7a8b9c0d1" \
    -H "Authorization: Bearer YOUR_API_KEY" \
    -H "Content-Type: application/json"
  ```

  ```javascript JavaScript theme={"system"}
  const uploadId = '65f1a2b3c4d5e6f7a8b9c0d1';
  const response = await fetch(`https://public.reap.video/api/v1/automation/delete-upload?uploadId=${uploadId}`, {
    method: 'DELETE',
    headers: {
      'Authorization': 'Bearer YOUR_API_KEY',
      'Content-Type': 'application/json'
    }
  });

  const data = await response.json();
  console.log(`Deleted: ${data.deleted}`);
  ```

  ```python Python theme={"system"}
  import requests

  headers = {
      'Authorization': 'Bearer YOUR_API_KEY',
      'Content-Type': 'application/json'
  }

  upload_id = '65f1a2b3c4d5e6f7a8b9c0d1'
  response = requests.delete(
      f'https://public.reap.video/api/v1/automation/delete-upload?uploadId={upload_id}',
      headers=headers
  )

  data = response.json()
  print(f"Deleted: {data['deleted']}")
  ```

  ```php PHP theme={"system"}
  <?php
  $uploadId = '65f1a2b3c4d5e6f7a8b9c0d1';
  $ch = curl_init('https://public.reap.video/api/v1/automation/delete-upload?uploadId=' . $uploadId);
  curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'DELETE');
  curl_setopt($ch, CURLOPT_HTTPHEADER, [
      'Authorization: Bearer YOUR_API_KEY',
      'Content-Type: application/json'
  ]);
  curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
  $response = curl_exec($ch);
  curl_close($ch);
  $data = json_decode($response, true);
  echo 'Deleted: ' . ($data['deleted'] ? 'true' : 'false') . "\n";
  ?>
  ```

  ```go Go theme={"system"}
  package main
  import (
      "fmt"
      "io/ioutil"
      "net/http"
  )
  func main() {
      uploadId := "65f1a2b3c4d5e6f7a8b9c0d1"
      url := fmt.Sprintf("https://public.reap.video/api/v1/automation/delete-upload?uploadId=%s", uploadId)
      req, _ := http.NewRequest("DELETE", url, nil)
      req.Header.Set("Authorization", "Bearer YOUR_API_KEY")
      req.Header.Set("Content-Type", "application/json")
      client := &http.Client{}
      resp, _ := client.Do(req)
      defer resp.Body.Close()
      body, _ := ioutil.ReadAll(resp.Body)
      fmt.Println(string(body))
  }
  ```

  ```java Java theme={"system"}
  import java.io.*;
  import java.net.HttpURLConnection;
  import java.net.URL;
  public class DeleteUploadExample {
      public static void main(String[] args) throws Exception {
          String uploadId = "65f1a2b3c4d5e6f7a8b9c0d1";
          URL url = new URL("https://public.reap.video/api/v1/automation/delete-upload?uploadId=" + uploadId);
          HttpURLConnection conn = (HttpURLConnection) url.openConnection();
          conn.setRequestMethod("DELETE");
          conn.setRequestProperty("Authorization", "Bearer YOUR_API_KEY");
          conn.setRequestProperty("Content-Type", "application/json");
          BufferedReader br = new BufferedReader(new InputStreamReader(conn.getInputStream(), "utf-8"));
          StringBuilder response = new StringBuilder();
          String responseLine;
          while ((responseLine = br.readLine()) != null) {
              response.append(responseLine.trim());
          }
          System.out.println(response.toString());
      }
  }
  ```
</CodeGroup>

## Example Response

<CodeGroup>
  <CodeGroup.Tab label="200 OK">
    ```json theme={"system"}
    {
      "uploadId": "65f1a2b3c4d5e6f7a8b9c0d1",
      "deleted": true
    }
    ```
  </CodeGroup.Tab>

  <CodeGroup.Tab label="401 Unauthorized">
    ```json theme={"system"}
    {
      "detail": "Unauthorized - Invalid or missing API key"
    }
    ```
  </CodeGroup.Tab>

  <CodeGroup.Tab label="404 Not Found">
    ```json theme={"system"}
    {
      "detail": "Upload not found"
    }
    ```
  </CodeGroup.Tab>

  <CodeGroup.Tab label="429 Too Many Requests">
    ```json theme={"system"}
    {
      "detail": "Too Many Requests - Rate limit of 10 requests per minute exceeded"
    }
    ```
  </CodeGroup.Tab>
</CodeGroup>


## OpenAPI

````yaml DELETE /automation/delete-upload
openapi: 3.1.0
info:
  title: Reap Automation API
  description: AI-powered video processing automation API
  version: 1.0.0
servers:
  - url: https://public.reap.video/api/v1
security:
  - bearerAuth: []
paths:
  /automation/delete-upload:
    delete:
      summary: Delete Upload
      description: Delete an uploaded file
      operationId: deleteUpload
      parameters:
        - $ref: '#/components/parameters/uploadId'
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DeleteUploadResponse'
components:
  parameters:
    uploadId:
      name: uploadId
      in: query
      required: true
      schema:
        type: string
      description: Unique identifier of the upload
  schemas:
    DeleteUploadResponse:
      type: object
      properties:
        uploadId:
          type: string
        deleted:
          type: boolean
          default: true
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

````