---
title: "Delete a file"
method: DELETE
path: "/files/{id}"
tags: ["File"]
---

# Delete a file

`DELETE /files/{id}`

## Request

- Base URL: `https://telescope.ac/api`
- URL: `https://telescope.ac/api/files/{id}`
- Auth: none declared

Deletes a file owned by the current user (best-effort S3 cleanup of the primary object).

**API credit cost:** 2

## Path parameters

- `id` string, uuid, required: ID of the file to delete.

## Headers

- `Authorization` string

## Response `200`

OK

- SimpleResultOutputBody
  - `$schema` string, uri: A URL to the JSON Schema for this object.
  - `result` string, required

## Other responses

- `default`: Error

---

[API](https://skmtc.dev/telescope/apis/telescope-api.md) - [All operations](https://skmtc.dev/telescope/apis/telescope-api/llms.txt) - [OpenAPI document](https://skmtc.dev/telescope/apis/telescope-api/revisions/e4bd44d7f2b0?raw)
