Detect Remote Filename

POST

/utilities/downloads/detect-filename

curl --request POST \
  --url https://sylve.lan:8181/api/utilities/downloads/detect-filename \
  --header 'Authorization: <Authorization>' \
  --header 'Content-Type: application/json' \
  --data '{ "ignoreTLS": true, "url": "example" }'

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

Authorizations

• BearerAuth

Request Body

Filename detection request

Media typeapplication/json

object

ignoreTLS

boolean

url

required

string

Example^generated

{
  "ignoreTLS": true,
  "url": "example"
}

Responses

200

Probe completed; filename may be empty

Media typeapplication/json

object

data

object

filename

string

error

string

message

string

status

string

Example^generated

{
  "data": {
    "filename": "example"
  },
  "error": "example",
  "message": "example",
  "status": "example"
}

400

Bad Request

Media typeapplication/json

object

data

error

string

message

string

status

string

Example^generated

{
  "data": "example",
  "error": "example",
  "message": "example",
  "status": "example"
}

401

Unauthorized

Media typeapplication/json

object

data

error

string

message

string

status

string

Example^generated

{
  "data": "example",
  "error": "example",
  "message": "example",
  "status": "example"
}

403

Administrator access required

Media typeapplication/json

object

data

error

string

message

string

status

string

Example^generated

{
  "data": "example",
  "error": "example",
  "message": "example",
  "status": "example"
}

413

Request body too large

Media typeapplication/json

object

data

error

string

message

string

status

string

Example^generated

{
  "data": "example",
  "error": "example",
  "message": "example",
  "status": "example"
}

500

Internal Server Error

Media typeapplication/json

object

data

error

string

message

string

status

string

Example^generated

{
  "data": "example",
  "error": "example",
  "message": "example",
  "status": "example"
}