All Products
Search
Document Center

STAROps:GetArtifactDownloadUrl

Last Updated:Jul 27, 2026

Retrieves the download URL for an artifact.

Operation description

Retrieves the download URL for artifact content. This operation is suitable for large files.

Try it now

Try this API in OpenAPI Explorer, no manual signing needed. Successful calls auto-generate SDK code matching your parameters. Download it with built-in credential security for local usage.

Test

RAM authorization

No authorization for this operation. If you encounter issues with this operation, contact technical support.

Request syntax

GET /digitalEmployee/{name}/artifacts/downloadUrl HTTP/1.1

Path Parameters

Parameter

Type

Required

Description

Example

name

string

Yes

The name of the digital worker.

sample-agent

Request parameters

Parameter

Type

Required

Description

Example

artifactPath

string

Yes

The artifact file path, relative to the digital worker artifact root directory.

reports/summary.pdf

Response elements

Element

Type

Description

Example

object

requestId

string

The request ID.

0A1B2C3D-4E5F-6789-ABCD-1234567890AB

url

string

The temporary download URL.

https://example-bucket.oss-cn-shanghai.aliyuncs.com/agents/123/sample-agent/home/starops/reports/summary.pdf?response-content-disposition=attachment&Expires=1770000000&OSSAccessKeyId=LTAI******&Signature=******

expire

integer

The expiration time of the download URL. This value is a UNIX timestamp in seconds.

1770000000

Examples

Success response

JSON format

{
  "requestId": "0A1B2C3D-4E5F-6789-ABCD-1234567890AB",
  "url": "https://example-bucket.oss-cn-shanghai.aliyuncs.com/agents/123/sample-agent/home/starops/reports/summary.pdf?response-content-disposition=attachment&Expires=1770000000&OSSAccessKeyId=LTAI******&Signature=******",
  "expire": 1770000000
}

Error codes

See Error Codes for a complete list.

Release notes

See Release Notes for a complete list.