asset_download
ManagementDownload Asset
Request a download URL for an asset, optionally converting to a target format.
Args:
- asset_id: required
- format: optional target format, e.g. "png" (default), "webp", "jpg"
- team_id, project_id: required for OAuth callers
Returns: download URL and metadata.
When saving the returned URL with a CLI such as curl, always follow redirects (for example: curl -L -o file.png "<url>") because asset transform URLs may redirect before serving the file.
Example: "Download this asset as WebP" -> asset_id="asset_xxx", format="webp"
open-world
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| asset_id | string | ✓ | Asset ID. |
| format | string | — | Target format, e.g. "png" (default) — mapped to the API's targetFormat. |
| team_id | string | — | Team ID. Required if user belongs to multiple teams. |
| project_id | string | — | Project ID to scope the operation to. |
| response_format | enum(json | markdown) | json | Output format: 'json' for structured data, 'markdown' for human-readable text. |