ci.artifacts.download

Download an artifact

GET /ci/api/artifacts/{artifactId}/downloadIAM ci:DownloadArtifactReadSensitive read, audited

Redirects (302) to a presigned storage URL valid for five minutes; over MCP the tool answers `{ url }` instead of the bytes. 410 once the artifact has expired.

Request syntax

GET /ci/api/artifacts/{artifactId}/download

Path parameters

  • artifactIdRequired

    string

    Constraints: uuid

Response

302 to a presigned storage URL valid for five minutes. 410 once the artifact has expired; 404 when it is not in this organization; 403, recorded in the audit log, without ci:DownloadArtifact.

The response is the raw content with its own content type, not JSON.

Errors

  • 400The request does not pass the schema above. The body is { "error": …, "issues": […] }, one issue per field.
  • 401No credentials, or an access key that is unknown, revoked or expired.
  • 403The caller's policies do not allow ci:DownloadArtifact on this resource. The body names the action and the resource, and the refusal is recorded in the audit log.
  • 404The resource does not exist in your organization.

Examples

The required parameters only, with example values. Replace id and the other placeholders with your own.

dcloud ci artifacts download artifactId

Generated from the API description, the same one the API checks requests against and the CLI is built from. MCP tool: dcloud_ci_artifacts_download.