Download an asset

Deprecated

POST

/v0/download-asset

• Beeper Desktop API server

Download a Matrix asset using its mxc:// or localmxc:// URL and return the local file URL. Use POST /v1/assets/download instead.

Request Body

object

url

required

Matrix content URL (mxc:// or localmxc://) for the asset to download.

string

>= 1 characters

Responses

200

Tool executed successfully

object

srcURL

Local file URL to the downloaded asset.

string

error

Error message if the download failed.

string

400

Invalid request parameters

object

error

required

Error message

string

code

Error code

string

details

Additional error details

object

key

additional properties

string

401

Access token is missing or invalid

object

error

required

Error message

string

code

Error code

string

details

Additional error details

object

key

additional properties

string

403

Access token does not have the required scope

object

error

required

Error message

string

code

Error code

string

details

Additional error details

object

key

additional properties

string

404

Resource not found

object

error

required

Error message

string

code

Error code

string

details

Additional error details

object

key

additional properties

string

422

Unprocessable entity - validation error

object

error

required

Error message

string

code

Error code

string

details

Additional error details

object

key

additional properties

string

429

Too many requests - rate limit exceeded

object

error

required

Error message

string

code

Error code

string

details

Additional error details

object

key

additional properties

string

500

Internal server error

object

error

required

Error message

string

code

Error code

string

details

Additional error details

object

key

additional properties

string