Builds - Get Build Work Items Refs

Service:

Build

API Version:

7.0

Gets the work items associated with a build. Only work items in the same project are returned.

GET https://dev.azure.com/{organization}/{project}/_apis/build/builds/{buildId}/workitems?api-version=7.0

With optional parameters:

GET https://dev.azure.com/{organization}/{project}/_apis/build/builds/{buildId}/workitems?$top={$top}&api-version=7.0

URI Parameters

Name	In	Required	Type	Description
buildId	path	True	integer int32	The ID of the build.
organization	path	True	string	The name of the Azure DevOps organization.
project	path	True	string	Project ID or project name
api-version	query	True	string	Version of the API to use. This should be set to '7.0' to use this version of the api.
$top	query		integer int32	The maximum number of work items to return.

Responses

Name	Type	Description
200 OK	ResourceRef[]	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

ResourceRef

Name	Type	Description
id	string
url	string