---
title: Download an asset - Beeper Developer Docs
---

Deprecated

POST/v0/download-asset

- Beeper Desktop API server http\://localhost:23373/v0/download-asset

Download a Matrix asset using its mxc:// or localmxc:// URL and return the local file URL. **Use [`POST /v1/assets/download`](/desktop-api-reference/resources/app/methods/downloadAsset/index.md) instead.**

## Request Body

Select media typeapplication/json

object

**url**

required

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

string

\>= 1 characters

## Responses

### 200

Tool executed successfully

Select media typeapplication/json

object

**srcURL**

Local file URL to the downloaded asset.

string

**error**

Error message if the download failed.

string

### 400

Invalid request parameters

Select media typeapplication/json

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

Select media typeapplication/json

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

Select media typeapplication/json

object

**error**

required

Error message

string

**code**

Error code

string

**details**

Additional error details

object

***key***

additional properties

string

### 404

Resource not found

Select media typeapplication/json

object

**error**

required

Error message

string

**code**

Error code

string

**details**

Additional error details

object

***key***

additional properties

string

### 422

Unprocessable entity - validation error

Select media typeapplication/json

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

Select media typeapplication/json

object

**error**

required

Error message

string

**code**

Error code

string

**details**

Additional error details

object

***key***

additional properties

string

### 500

Internal server error

Select media typeapplication/json

object

**error**

required

Error message

string

**code**

Error code

string

**details**

Additional error details

object

***key***

additional properties

string