---
title: "Detect Remote Filename"
method: POST
path: "/utilities/downloads/detect-filename"
tags: ["Utilities"]
---

# Detect Remote Filename

`POST /utilities/downloads/detect-filename`

Best-effort HEAD probe that reports the filename an HTTP(S) source advertises through Content-Disposition; an empty filename means the source named nothing

## Request body

- InternalHandlersUtilitiesDetectFilenameRequest
  - `ignoreTLS` boolean
  - `url` string, required

## Response `200`

Probe completed; filename may be empty

- GithubComAlchemillahqSylveInternalAPIResponseInternalHandlersUtilitiesDetectFilenameResponse
  - `data` InternalHandlersUtilitiesDetectFilenameResponse
    - `filename` string
  - `error` string
  - `message` string
  - `status` string

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Administrator access required
- `413` — Request body too large
- `500` — Internal Server Error

## Changes

- **2026-09-15** `f1c5f8388fd6` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/alchemillahq/apis/sylve-api/changes/utilities/downloads/detect-filename/post.md)

---

[API](https://skmtc.dev/alchemillahq/apis/sylve-api.md) · [All operations](https://skmtc.dev/alchemillahq/apis/sylve-api/llms.txt) · [OpenAPI document](https://skmtc.dev/alchemillahq/apis/sylve-api/revisions/85f3f607253e?raw)