Artifacts - Get

Service:

Pipelines

API Version:

7.1-preview.1

Get a specific artifact from a pipeline run

GET https://dev.azure.com/{organization}/{project}/_apis/pipelines/{pipelineId}/runs/{runId}/artifacts?artifactName={artifactName}&api-version=7.1-preview.1

With optional parameters:

GET https://dev.azure.com/{organization}/{project}/_apis/pipelines/{pipelineId}/runs/{runId}/artifacts?artifactName={artifactName}&$expand={$expand}&api-version=7.1-preview.1

URI Parameters

Name	In	Required	Type	Description
organization	path	True	string	The name of the Azure DevOps organization.
pipelineId	path	True	integer int32	ID of the pipeline.
project	path	True	string	Project ID or project name
runId	path	True	integer int32	ID of the run of that pipeline.
api-version	query	True	string	Version of the API to use. This should be set to '7.1-preview.1' to use this version of the api.
artifactName	query	True	string	Name of the artifact.
$expand	query		GetArtifactExpandOptions	Expand options. Default is None.

Responses

Name	Type	Description
200 OK	Artifact	successful operation

Security

oauth2

Type: oauth2
Flow: accessCode
Authorization URL: https://app.vssps.visualstudio.com/oauth2/authorize&response_type=Assertion
Token URL: https://app.vssps.visualstudio.com/oauth2/token?client_assertion_type=urn:ietf:params:oauth:client-assertion-type:jwt-bearer&grant_type=urn:ietf:params:oauth:grant-type:jwt-bearer

Scopes

Name	Description
vso.build	Grants the ability to access build artifacts, including build results, definitions, and requests, and the ability to receive notifications about build events via service hooks.

Definitions

Name	Description
Artifact	Artifacts are collections of files produced by a pipeline. Use artifacts to share files between stages in a pipeline or between different pipelines.
GetArtifactExpandOptions	Expand options. Default is None.
SignedUrl	A signed url allowing limited-time anonymous access to private resources.

Artifact

Artifacts are collections of files produced by a pipeline. Use artifacts to share files between stages in a pipeline or between different pipelines.

Name	Type	Description
name	string	The name of the artifact.
signedContent	SignedUrl	Signed url for downloading this artifact
url	string	Self-referential url

GetArtifactExpandOptions

Expand options. Default is None.

Name	Type	Description
none	string	No expansion.
signedContent	string	Include signed content.

SignedUrl

A signed url allowing limited-time anonymous access to private resources.

Name	Type	Description
signatureExpires	string	Timestamp when access expires.
url	string	The URL to allow access to.