Azure DevOps

Azure DevOps provides services for teams to share code, track work, and ship software - for any language, all in a single package. It's the perfect complement to your IDE.

This connector is available in the following products and regions:

Service Class Regions
Logic Apps Standard All Logic Apps regions except the following:
     -   Azure China regions
Flow Standard All Flow regions
PowerApps Standard All PowerApps regions

To use this integration, you will need access to a Visual Studio Team Services account with API access enabled. To make a connection, select Sign In. You will be prompted to provide your Visual Studio Team Services account, follow the remainder of the screens to create a connection.

When using the connection, if you're not seeing the list of projects you're expecting please check the account you created the connection with and try again. More details can be found on the Visual Studio Marketplace.

You're now ready to start using this integration.

Known issues and limitations

  1. The action Send an HTTP request to Azure DevOps only supports content in Json. If it is used to try to upload a binary file the action will succeed, but the file will be in a corrupted state. We are in the designing stage to support binary content in the future.

Throttling Limits

Name Calls Renewal Period
API calls per connection6060 seconds

Actions

Create a new release

Create a release, based on an existing release definition.

Create a work item

Create a new work item with the provided attributes.

Get query results

Retrieves the result of a work item query.

Get query results [DEPRECATED]

Retrieves the result of a work item query.

Get work item children

Get a list of children (max size 1000) of a single work item.

Get work item details

Get the details of a single work item.

List iterations

Retrieves the list of iterations for a project.

List queries within folder

Retrieves the list of work item queries within a folder for a given project.

List release definitions

Retrieves the list of release definitions associated with a project.

List root level queries

Retrieves the list of root-level work item queries in a project.

List work item types

Retrieves the list of Work Item Types accessible in a given Azure DevOps project.

List work items

Returns a list of work items.

Queue a new build

Create a build, based on an existing build definition, and add it to the build queue.

Send an HTTP request to Azure DevOps

Construct an Azure DevOps REST API request to invoke.

Update a work item

Update an existing work item by id.

Create a new release

Create a release, based on an existing release definition.

Parameters

Name Key Required Type Description
Account Name
account True string

The name of the account. This can be found in the instance URL i.e. {account}.visualstudio.com. The account should have "Third-party application access via OAuth" enabled to prevent errors in the operation.

Project Name
project True string

The name of the project within the specified account.

Release Definition Id
releaseDefId True string

The identifier of the release definition to use.

Description
Description string

The description of the release start metadata.

Is Draft
IsDraft boolean

Specifies whether the release is a draft.

Reason
Reason string

The reason for the release start metadata.

Name
Name True string

The name of the configuration variable.

Value
Value string

The value of the configuration variable.

Returns

Release

Body
Release

Create a work item

Create a new work item with the provided attributes.

Parameters

Name Key Required Type Description
Account Name
account True string

The name of the account. This can be found in the instance URL i.e. {account}.visualstudio.com. The account should have "Third-party application access via OAuth" enabled to prevent errors in the operation.

Project Name
project True string

The name of the project within the specified account.

Work Item Type
type True string

Type of this work item

Work Item Details
workItem True dynamic

Information to include in the new work item

Returns

The outputs of this operation are dynamic.

Get query results

Retrieves the result of a work item query.

Parameters

Name Key Required Type Description
Account Name
account True string

The name of the account. This can be found in the instance URL i.e. {account}.visualstudio.com. The account should have "Third-party application access via OAuth" enabled to prevent errors in the operation.

Project Name
project True string

The name of the project within the specified account.

Query Id
queryId True string

The Id of the stored query to run.

Number of work items to return
workItemsCount integer

Max work items count to retrieve (1 - 1000)

Returns

The outputs of this operation are dynamic.

Get query results [DEPRECATED]

Retrieves the result of a work item query.

Parameters

Name Key Required Type Description
Account Name
account True string

The name of the account. This can be found in the instance URL i.e. {account}.visualstudio.com. The account should have "Third-party application access via OAuth" enabled to prevent errors in the operation.

Project Name
project True string

The name of the project within the specified account.

Query Id
queryId True string

The Id of the stored query to run.

Returns

A list of VSTS models.

Get work item children

Get a list of children (max size 1000) of a single work item.

Parameters

Name Key Required Type Description
Account Name
account True string

The name of the account. This can be found in the instance URL i.e. {account}.visualstudio.com. The account should have "Third-party application access via OAuth" enabled to prevent errors in the operation.

Project Name
project True string

The name of the project within the specified account.

Work Item Id
id True string

The unique id of the work item to get the children for.

Children Work Item Type
workItemType string

The type of the children work item(s)

Returns

The outputs of this operation are dynamic.

Get work item details

Get the details of a single work item.

Parameters

Name Key Required Type Description
Account Name
account True string

The name of the account. This can be found in the instance URL i.e. {account}.visualstudio.com. The account should have "Third-party application access via OAuth" enabled to prevent errors in the operation.

Project Name
project True string

The name of the project within the specified account.

Work Item Type
typeName True string

The work item type of the work item.

Work Item Id
id True string

The unique id of the work item to get details for.The work item must be of the type specified in 'Work Item Type'.

Returns

The outputs of this operation are dynamic.

List iterations

Retrieves the list of iterations for a project.

Parameters

Name Key Required Type Description
Account Name
account True string

The name of the account. This can be found in the instance URL i.e. {account}.visualstudio.com. The account should have "Third-party application access via OAuth" enabled to prevent errors in the operation.

Project Name
project True string

The name of the project within the specified account.

Team Name
team True string

The name of the team within the project.

Returns

A list of VSTS models.

List queries within folder

Retrieves the list of work item queries within a folder for a given project.

Parameters

Name Key Required Type Description
Account Name
account True string

The name of the account. This can be found in the instance URL i.e. {account}.visualstudio.com. The account should have "Third-party application access via OAuth" enabled to prevent errors in the operation.

Project Name
project True string

The name of the project within the specified account.

Folder Path
folderPath True string

The folder path under which to look for queries.

Returns

A list of VSTS models.

List release definitions

Retrieves the list of release definitions associated with a project.

Parameters

Name Key Required Type Description
Account Name
account True string

The name of the account. This can be found in the instance URL i.e. {account}.visualstudio.com. The account should have "Third-party application access via OAuth" enabled to prevent errors in the operation.

Project Name
project True string

The name of the project within the specified account.

Returns

A list of VSTS models.

List root level queries

Retrieves the list of root-level work item queries in a project.

Parameters

Name Key Required Type Description
Account Name
account True string

The name of the account. This can be found in the instance URL i.e. {account}.visualstudio.com. The account should have "Third-party application access via OAuth" enabled to prevent errors in the operation.

Project Name
project True string

The name of the project within the specified account.

Returns

A list of VSTS models.

List work item types

Retrieves the list of Work Item Types accessible in a given Azure DevOps project.

Parameters

Name Key Required Type Description
Account Name
account True string

The name of the account. This can be found in the instance URL i.e. {account}.visualstudio.com. The account should have "Third-party application access via OAuth" enabled to prevent errors in the operation.

Project Name
project True string

The name of the project within the specified account.

Returns

A list of VSTS models.

List work items

Returns a list of work items.

Parameters

Name Key Required Type Description
Account Name
account True string

The name of the account. This can be found in the instance URL i.e. {account}.visualstudio.com. The account should have "Third-party application access via OAuth" enabled to prevent errors in the operation.

Project Name
project True string

The name of the project within the specified account.

Work Item IDs
workItemIds True string

The comma-separated list of requested work item IDs.

Work Item Type
workItemType string

The work item type to generate schema for.

Returns

The outputs of this operation are dynamic.

Queue a new build

Create a build, based on an existing build definition, and add it to the build queue.

Parameters

Name Key Required Type Description
Account Name
account True string

The name of the account. This can be found in the instance URL i.e. {account}.visualstudio.com. The account should have "Third-party application access via OAuth" enabled to prevent errors in the operation.

Project Name
project True string

The name of the project within the specified account.

Build Definition Id
buildDefId True string

The identifier of the build definition to use.

Source Branch
sourceBranch string

The source branch of the build.

Parameters
parameters string

A JSON dictionary of optional build parameters.

Returns

Build Result

Send an HTTP request to Azure DevOps

Construct an Azure DevOps REST API request to invoke.

Parameters

Name Key Required Type Description
Account Name
account True string

The name of the account. This can be found in the instance URL i.e. {account}.visualstudio.com. The account should have "Third-party application access via OAuth" enabled to prevent errors in the operation.

Method
Method True string

The HTTP method.

Relative URI
Uri True string

The relative URI. Example: {project}/{team}/_apis/wit/templates?api-version=5.0-preview.1.

Body
Body string

The request content in JSON or Base64.

Body is Base64
IsBase64 boolean

Request content is encoded as Base64.

Update a work item

Update an existing work item by id.

Parameters

Name Key Required Type Description
Account Name
account True string

The name of the account. This can be found in the instance URL i.e. {account}.visualstudio.com. The account should have "Third-party application access via OAuth" enabled to prevent errors in the operation.

Work Item Id
id True string

The unique id of the work item to update.

Project Name
project string

The name of the project within the specified account.

Work Item Type
type string

The work item type to generate schema for.

Work Item Details
workItem True dynamic

The details of the work item.

Returns

The outputs of this operation are dynamic.

Triggers

When a build completes

Triggers a flow when a build completes.

When a work item is assigned

Triggers a flow when a work item which matches provided criteria is assigned to the given user.

When a work item is assigned

Triggers a flow when a work item which matches provided criteria is assigned to the given user.

When a work item is closed

Triggers a flow when a work item which matches provided criteria is closed.

When a work item is closed

Triggers a flow when a work item which matches provided criteria is closed.

When a work item is created

Triggers a flow when a work item which matches provided criteria is created.

When a work item is created

Triggers a flow when a work item which matches provided criteria is created.

When a work item is updated

Triggers a flow when a work item which matches provided criteria is updated.

When a work item is updated

Triggers a flow when a work item which matches provided criteria is updated.

When code is checked in (TFVC)

Triggers a flow when code is checked in to a Team Foundation Version Control project.

When code is pushed (Git)

Triggers a flow when code is pushed to a Git repository.

When a build completes

Triggers a flow when a build completes.

Parameters

Name Key Required Type Description
Account Name
account True string

The name of the account. This can be found in the instance URL i.e. {account}.visualstudio.com. The account should have "Third-party application access via OAuth" enabled to prevent errors in the operation.

Project Name
project True string

The name of the project within the specified account.

Filter By Result
resultFilter string

An option indicating which build result to trigger on. Valid options include '', 'succeeded', 'partiallySucceeded', 'failed', or 'canceled'.

Filter By Definition Id
definitions string

An option indicating which build definition id to trigger on.

Returns

A list of VSTS models.

When a work item is assigned

Triggers a flow when a work item which matches provided criteria is assigned to the given user.

Parameters

Name Key Required Type Description
Account Name
account True string

The name of the account. This can be found in the instance URL i.e. {account}.visualstudio.com. The account should have "Third-party application access via OAuth" enabled to prevent errors in the operation.

Project Name
project True string

The name of the project within the specified account.

Assigned To
wiql__System_AssignedTo True string

The name of the team member who currently owns the work item.

Team Name (to pick Assigned To)
team string

The name of the team from which to select a member.

Type
wiql__System_WorkItemType string

The name of the work item type. Valid options include 'Bug, 'Epic', etc.

Area Path
wiql__System_AreaPath string

The product feature or team area the work item is in.

Area Path Comparison
areaPathComparison string

The rule to be used while comparing Area Path field.

Iteration Path
wiql__System_IterationPath string

The named sprint or time period the work item is in.

Iteration Path Comparison
iterationPathComparison string

The rule to be used while comparing Iteration Path field.

Priority
wiql__Microsoft_VSTS_Common_Priority string

A subjective rating of the bug, issue, task, or test case as it relates to the business.

Team Project
wiql__System_TeamProject string

The team project to which this work item belongs.

Created By
wiql__System_CreatedBy string

The name of the team member who created the work item.

Returns

The outputs of this operation are dynamic.

When a work item is assigned

Triggers a flow when a work item which matches provided criteria is assigned to the given user.

Parameters

Name Key Required Type Description
Account Name
account True string

The name of the account. This can be found in the instance URL i.e. {account}.visualstudio.com. The account should have "Third-party application access via OAuth" enabled to prevent errors in the operation.

Project Name
project True string

The name of the project within the specified account.

Team Name (to pick Assigned To)
team True string

The name of the team from which to select a member.

Assigned To
wiql__System_AssignedTo True string

The name of the team member who currently owns the work item.

Type
wiql__System_WorkItemType string

The name of the work item type. Valid options include 'Bug, 'Epic', etc.

Area Path
wiql__System_AreaPath string

The product feature or team area the work item is in.

Area Path Comparison
areaPathComparison string

The rule to be used while comparing Area Path field.

Iteration Path
wiql__System_IterationPath string

The named sprint or time period the work item is in.

Iteration Path Comparison
iterationPathComparison string

The rule to be used while comparing Iteration Path field.

Priority
wiql__Microsoft_VSTS_Common_Priority string

A subjective rating of the bug, issue, task, or test case as it relates to the business.

Created By
wiql__System_CreatedBy string

The name of the team member who created the work item.

Returns

The outputs of this operation are dynamic.

When a work item is closed

Triggers a flow when a work item which matches provided criteria is closed.

Parameters

Name Key Required Type Description
Account Name
account True string

The name of the account. This can be found in the instance URL i.e. {account}.visualstudio.com. The account should have "Third-party application access via OAuth" enabled to prevent errors in the operation.

Project Name
project True string

The name of the project within the specified account.

Team Name (to pick Assigned To)
team string

The name of the team from which to select an assignee.

Assigned To
wiql__System_AssignedTo string

The name of the team member who currently owns the work item.

Type
wiql__System_WorkItemType string

The name of the work item type.

Closed State
closedState string

The comma-separated list of values of the State field indicating how the work item was closed (Done, Closed, Completed, Inactive).

Area Path
wiql__System_AreaPath string

The product feature or team area the work item is in.

Area Path Comparison
areaPathComparison string

The rule to be used while comparing Area Path field.

Iteration Path
wiql__System_IterationPath string

The named sprint or time period the work item is in.

Iteration Path Comparison
iterationPathComparison string

The rule to be used while comparing Iteration Path field.

Priority
wiql__Microsoft_VSTS_Common_Priority string

A subjective rating of the bug, issue, task, or test case as it relates to the business.

Created By
wiql__System_CreatedBy string

The name of the team member who created the work item.

Returns

The outputs of this operation are dynamic.

When a work item is closed

Triggers a flow when a work item which matches provided criteria is closed.

Parameters

Name Key Required Type Description
Account Name
account True string

The name of the account. This can be found in the instance URL i.e. {account}.visualstudio.com. The account should have "Third-party application access via OAuth" enabled to prevent errors in the operation.

Project Name
project True string

The name of the project within the specified account.

Team Name (to pick Assigned To)
team string

The name of the team from which to select an assignee.

Assigned To
wiql__System_AssignedTo string

The name of the team member who currently owns the work item.

Type
wiql__System_WorkItemType string

The name of the work item type. Valid options include 'Bug', 'Epic', etc.

Area Path
wiql__System_AreaPath string

The product feature or team area the work item is in.

Area Path Comparison
areaPathComparison string

The rule to be used while comparing Area Path field.

Iteration Path
wiql__System_IterationPath string

The named sprint or time period the work item is in.

Iteration Path Comparison
iterationPathComparison string

The rule to be used while comparing Iteration Path field.

Priority
wiql__Microsoft_VSTS_Common_Priority string

A subjective rating of the bug, issue, task, or test case as it relates to the business.

Team Project
wiql__System_TeamProject string

The team project to which this work item belongs.

Created By
wiql__System_CreatedBy string

The name of the team member who created the work item.

Returns

The outputs of this operation are dynamic.

When a work item is created

Triggers a flow when a work item which matches provided criteria is created.

Parameters

Name Key Required Type Description
Account Name
account True string

The name of the account. This can be found in the instance URL i.e. {account}.visualstudio.com. The account should have "Third-party application access via OAuth" enabled to prevent errors in the operation.

Project Name
project True string

The name of the project within the specified account.

Team Name (to pick Assigned To)
team string

The name of the team from which to select an assignee.

Assigned To
wiql__System_AssignedTo string

The name of the team member who currently owns the work item.

Type
wiql__System_WorkItemType string

The name of the work item type. Valid options include 'Bug', 'Epic', etc.

Area Path
wiql__System_AreaPath string

The product feature or team area the work item is in.

Area Path Comparison
areaPathComparison string

The rule to be used while comparing Area Path field.

Iteration Path
wiql__System_IterationPath string

The named sprint or time period the work item is in.

Iteration Path Comparison
iterationPathComparison string

The rule to be used while comparing Iteration Path field.

Priority
wiql__Microsoft_VSTS_Common_Priority string

A subjective rating of the bug, issue, task, or test case as it relates to the business.

Team Project
wiql__System_TeamProject string

The team project to which this work item belongs.

Created By
wiql__System_CreatedBy string

The name of the team member who created the work item.

Returns

The outputs of this operation are dynamic.

When a work item is created

Triggers a flow when a work item which matches provided criteria is created.

Parameters

Name Key Required Type Description
Account Name
account True string

The name of the account. This can be found in the instance URL i.e. {account}.visualstudio.com. The account should have "Third-party application access via OAuth" enabled to prevent errors in the operation.

Project Name
project True string

The name of the project within the specified account.

Team Name (to pick Assigned To)
team string

The name of the team from which to select an assignee.

Assigned To
wiql__System_AssignedTo string

The name of the team member who currently owns the work item.

Type
wiql__System_WorkItemType string

The name of the work item type. Valid options include 'Bug', 'Epic', etc.

Area Path
wiql__System_AreaPath string

The product feature or team area the work item is in.

Area Path Comparison
areaPathComparison string

The rule to be used while comparing Area Path field.

Iteration Path
wiql__System_IterationPath string

The named sprint or time period the work item is in.

Iteration Path Comparison
iterationPathComparison string

The rule to be used while comparing Iteration Path field.

Priority
wiql__Microsoft_VSTS_Common_Priority string

A subjective rating of the bug, issue, task, or test case as it relates to the business.

Created By
wiql__System_CreatedBy string

The name of the team member who created the work item.

Returns

The outputs of this operation are dynamic.

When a work item is updated

Triggers a flow when a work item which matches provided criteria is updated.

Parameters

Name Key Required Type Description
Account Name
account True string

The name of the account. This can be found in the instance URL i.e. {account}.visualstudio.com. The account should have "Third-party application access via OAuth" enabled to prevent errors in the operation.

Project Name
project True string

The name of the project within the specified account.

Team Name (to pick Assigned To)
team string

The name of the team from which to select an assignee.

Assigned To
wiql__System_AssignedTo string

The name of the team member who currently owns the work item.

Type
wiql__System_WorkItemType string

The name of the work item type. Valid options include 'Bug', 'Epic', etc.

Area Path
wiql__System_AreaPath string

The product feature or team area the work item is in.

Area Path Comparison
areaPathComparison string

The rule to be used while comparing Area Path field.

Iteration Path
wiql__System_IterationPath string

The named sprint or time period the work item is in.

Iteration Path Comparison
iterationPathComparison string

The rule to be used while comparing Iteration Path field.

Priority
wiql__Microsoft_VSTS_Common_Priority string

A subjective rating of the bug, issue, task, or test case as it relates to the business.

Created By
wiql__System_CreatedBy string

The name of the team member who created the work item.

Returns

The outputs of this operation are dynamic.

When a work item is updated

Triggers a flow when a work item which matches provided criteria is updated.

Parameters

Name Key Required Type Description
Account Name
account True string

The name of the account. This can be found in the instance URL i.e. {account}.visualstudio.com. The account should have "Third-party application access via OAuth" enabled to prevent errors in the operation.

Project Name
project True string

The name of the project within the specified account.

Team Name (to pick Assigned To)
team string

The name of the team from which to select an assignee.

Assigned To
wiql__System_AssignedTo string

The name of the team member who currently owns the work item.

Type
wiql__System_WorkItemType string

The name of the work item type. Valid options include 'Bug', 'Epic', etc.

Area Path
wiql__System_AreaPath string

The product feature or team area the work item is in.

Area Path Comparison
areaPathComparison string

The rule to be used while comparing Area Path field.

Iteration Path
wiql__System_IterationPath string

The named sprint or time period the work item is in.

Iteration Path Comparison
iterationPathComparison string

The rule to be used while comparing Iteration Path field.

Priority
wiql__Microsoft_VSTS_Common_Priority string

A subjective rating of the bug, issue, task, or test case as it relates to the business.

Team Project
wiql__System_TeamProject string

The team project to which this work item belongs.

Created By
wiql__System_CreatedBy string

The name of the team member who created the work item.

Returns

The outputs of this operation are dynamic.

When code is checked in (TFVC)

Triggers a flow when code is checked in to a Team Foundation Version Control project.

Parameters

Name Key Required Type Description
Account Name
account True string

The name of the account. This can be found in the instance URL i.e. {account}.visualstudio.com. The account should have "Third-party application access via OAuth" enabled to prevent errors in the operation.

Project Name
project True string

The name of the project within the specified account.

Team Name
team string

The name of the team which to select an author.

Team Member
author string

The unique name of the team member who authored the check in.

Returns

A list of VSTS models.

When code is pushed (Git)

Triggers a flow when code is pushed to a Git repository.

Parameters

Name Key Required Type Description
Account Name
account True string

The name of the account. This can be found in the instance URL i.e. {account}.visualstudio.com. The account should have "Third-party application access via OAuth" enabled to prevent errors in the operation.

Project Name
project True string

The name of the project within the specified account.

Repository Name
repository True string

The name of the repository within the specified project.

Ref Name
refName string

The name of the Git ref, such as a branch or tag.

Returns

A list of VSTS models.

Definitions

VstsList[TeamSettingsIteration]

A list of VSTS models.

Name Path Type Description
Value
value array of TeamSettingsIteration

The VSTS Models

TeamSettingsIteration

Work (Agile) Iteration

Name Path Type Description
Attributes
Attributes TeamIterationAttributes

Team Iteration Attributes

Id
Id string

Id of the resource.

Name
Name string

Name of the resource.

Path
Path string

Relative path to the iteration.

Links
_links object

Collection of links relevant to resource.

URL
Url string

Full HTTP link to the resource.

TeamIterationAttributes

Team Iteration Attributes

Name Path Type Description
Finish Date
FinishDate date-time

The finish date team iteration attribute.

Start Date
StartDate date-time

The start date team iteration attribute.

Links

Name Path Type Description
web
web WebLinks

Web Links

Web Links

Name Path Type Description
HTML Link
href string

The web URL of build details

BuildResult

Build Result

Name Path Type Description
Build Id
id integer

The unique identifier of the build.

Build Number
buildNumber string

The build number.

Source Branch
sourceBranch string

The source control branch the build used.

Source version
sourceVersion string

The source control version the build used.

Status
status string

The status of the build.

Priority
priority string

The priority of the build.

Queue Time
queueTime date-time

The time the build was queued.

Start Time
startTime date-time

The time the build started.

Finish Time
finishTime date-time

The time the build finished.

Reason
reason string

The reason for the build.

Result
result string

The result of the build.

requestedFor
requestedFor BuildRequestUser

Build Request User

Parameters
parameters string

Parameters passed to the build, if any.

definition
definition BuildResultDefinition

Build Result Definition

_links
_links Links

Links

BuildRequestUser

Build Request User

Name Path Type Description
Requested For
uniqueName string

The unique name of the user the build was requested for.

BuildResultDefinition

Build Result Definition

Name Path Type Description
Build Definition Id
id integer

The identifier of the build definiton.

Build Definition Name
name string

The name of the build definition.

VstsList[BuildResult]

A list of VSTS models.

Name Path Type Description
Value
value array of BuildResult

The VSTS Models

GitRepository

Git Repository

Name Path Type Description
Repository Id
id string

The unique id of the repository.

Repository Name
name string

The name of the repository.

Repository Browser URL
url string

The URL url that can be used in a browser to view this repository.

Repository Remote URL
remoteUrl string

The URL via which git can sync with this repository.

VstsList[GitPush]

A list of VSTS models.

Name Path Type Description
Value
value array of GitPush

The VSTS Models

GitPush

Git Push

Name Path Type Description
repository
repository GitRepository

Git Repository

pushedBy
pushedBy GitPushUser

Git Push User

Ref Updates
refUpdates array of GitRefUpdate

The Refs that were updated as part of this push.

Push Id
pushId integer

The unique id of the push.

Date
date date-time

The date the push was created.

GitPushUser

Git Push User

Name Path Type Description
Pusher Id
id string

The unique identifier of the user who created the push.

Pusher Name
displayName string

The name of the user who created the push.

Pusher Unique Name
uniqueName string

The unique name of the user who created the push.

Pusher Image Url
imageUrl string

The url to the image for this user.

GitRefUpdate

Git Ref Update

Name Path Type Description
Ref Name
name string

The name of the Git Ref that was updated.

Repository Id
repositoryId string

The unique id of the repository.

Old Commit Id
oldObjectId string

The id of the previous commit this Ref pointed to before the update.

New Commit Id
newObjectId string

The id of the new commit this Ref pointed to before the update.

VstsList[ReleaseDefinition]

A list of VSTS models.

Name Path Type Description
Value
value array of ReleaseDefinition

The VSTS Models

ReleaseDefinition

Release Definition

Name Path Type Description
Comment
Comment string

The comment of the release definition.

Created On
CreatedOn date-time

The date on which the release definition was created.

Description
Description string

The description of the release definition.

Id
Id integer

The unique identifier of the release definition.

ModifiedBy
ModifiedBy IdentityRef

Identity Ref

Modified On
ModifiedOn date-time

The date on which the release definition was modified.

Name
Name string

The name of the release definition.

Path
Path string

The path of the release definition.

Release Name Format
ReleaseNameFormat string

The release name format of the release definition.

Revision
Revision integer

The revision number of the release definition.

Source
Source string

The source of the release definition.

Tags
Tags array of string

The list of tags of the release definition.

URL
Url string

The URL to access the release definition.

IdentityRef

Identity Ref

Name Path Type Description
Directory Alias
DirectoryAlias string

The directory alias of the identity reference.

Display Name
DisplayName string

The display name of the identity reference.

Unique Name
UniqueName string

The unique name of the identity reference.

URL
Url string

The URL of the identity reference.

ReleaseDefinitionShallowReference

Release Definition Shallow Reference

Name Path Type Description
Id
Id integer

The unique identifier of the release definition.

Name
Name string

The name of the release definition.

URL
Url string

The REST API URL to access the release definition.

Object

Release

Release

Name Path Type Description
Comment
Comment string

The comment of the release.

CreatedBy
CreatedBy IdentityRef

Identity Ref

Created On
CreatedOn date-time

The date on which the release was created.

Description
Description string

The description of the release.

Id
Id integer

The unique Identifier of the release.

Keep Forever
KeepForever boolean

Whether to exclude the release from retention policies.

Logs Container URL
LogsContainerUrl string

The logs Container URL of this release.

ModifiedBy
ModifiedBy IdentityRef

Identity Ref

Modified On
ModifiedOn date-time

Date on which the release was modified.

Name
Name string

The name of the release.

Reason
Reason string

The reason of the release.

ReleaseDefinition
ReleaseDefinition ReleaseDefinitionShallowReference

Release Definition Shallow Reference

Status
Status string

The status of the release.

URL
Url string

The URL of the release.

VstsList[TfvcChangeset]

A list of VSTS models.

Name Path Type Description
Value
value array of TfvcChangeset

The VSTS Models

TfvcChangeset

Team Foundation Version Control Changeset

Name Path Type Description
Changeset Id
changesetId integer

The unique id of the changeset.

author
author ChangesetAuthor

Changeset Author

checkedInBy
checkedInBy ChangesetCheckedInBy

Changeset Checked In By

Created Date
createdDate date-time

The datetime the changeset was created.

Comment
comment string

The comment describing the changeset.

ChangesetAuthor

Changeset Author

Name Path Type Description
Author Name
displayName string

The name of the user who created the changeset.

Author Unique Name
uniqueName string

The unique name of the user who created the changeset.

ChangesetCheckedInBy

Changeset Checked In By

Name Path Type Description
Checked In By Name
displayName string

The name of the user who checked in the changeset.

Checked In By Unique Name
uniqueName string

The unique name of the user who created the changeset.

VstsList[WorkItemType]

A list of VSTS models.

Name Path Type Description
Value
value array of WorkItemType

The VSTS Models.

WorkItemType

Work Item Type

Name Path Type Description
Description
Description string

The description of the type.

Name
Name string

The name of the type.

XML Form
XmlForm string

An XML representation of the type.

Fields
FieldInstances array of WorkItemTypeFieldInstance

A list of field instances associated with the type.

WorkItemTypeFieldInstance

Work Item Type Field Instance

Name Path Type Description
Always Required
AlwaysRequired boolean

Specifies whether the field instance is always required.

Reference Name
ReferenceName string

The reference name of the field instance.

Name
Name string

The name of the field instance.

URL
Url string

A URL pointing to field instance details.

VstsList[JObject]

A list of VSTS models.

Name Path Type Description
Value
value array of Object

The VSTS Models

VstsList[QueryHierarchyItem]

A list of VSTS models.

Name Path Type Description
Value
value array of QueryHierarchyItem

The VSTS Models

QueryHierarchyItem

Query Hierarchy Item

Name Path Type Description
Children
Children array of QueryHierarchyItem

The list of children items associated with the query hierarchy item.

Clauses
Clauses WorkItemQueryClause

Work Item Query Clause

Columns
Columns array of WorkItemFieldReference

The list of work item field columns associated with the query hierarchy item.

Filter Options
FilterOptions string

The filter options of the query hierarchy item.

Has Children
HasChildren boolean

Specifies whether the query hierarchy item has children.

Id
Id string

The unique identifer of the query hierarchy item.

Is Deleted
IsDeleted boolean

Specifies whether the query hierarchy item is deleted.

Is Folder
IsFolder boolean

Specifies whether the query hierarchy item is a folder.

Is Invalid Syntax
IsInvalidSyntax boolean

Specifies whether the query hierarchy item has invalid syntax.

Is Public
IsPublic boolean

Specifies whether the query hierarchy item is public.

LinkClauses
LinkClauses WorkItemQueryClause

Work Item Query Clause

Name
Name string

The name of the query hierarchy item.

Path
Path string

The path of the query hierarchy item.

Query Type
QueryType string

The query type of the query hierarchy item.

Sort Columns
SortColumns array of WorkItemQuerySortColumn

The list of sort columns of the query hierarchy item.

SourceClauses
SourceClauses WorkItemQueryClause

Work Item Query Clause

TargetClauses
TargetClauses WorkItemQueryClause

Work Item Query Clause

Wiql
Wiql string

The WIQL of the query hierarchy item.

Links
_links object

The collection of links relevant to the query hierarchy item.

URL
Url string

The full HTTP link to the query hierarchy item.

WorkItemQueryClause

Work Item Query Clause

Name Path Type Description
Clauses
Clauses WorkItemQueryClause

Work Item Query Clause

Field
Field WorkItemFieldReference

Work Item Field Reference

FieldValue
FieldValue WorkItemFieldReference

Work Item Field Reference

Is Field Value
IsFieldValue boolean

Specifies whether the work item query clause is a field value.

Logical Operator
LogicalOperator string

The logical operator of the work item query clause.

Operator
Operator WorkItemFieldOperation

Work Item Field Operation

Value
Value string

The value of the work item query clause.

WorkItemFieldReference

Work Item Field Reference

Name Path Type Description
Name
Name string

The name of the work item field reference.

Reference Name
ReferenceName string

The reference name of the work item field reference.

URL
Url string

The URL of the work item field reference.

WorkItemQuerySortColumn

Work Item Query Sort Column

Name Path Type Description
Descending
Descending boolean

Specifies whether the work item query sort column is descending.

Field
Field WorkItemFieldReference

Work Item Field Reference

WorkItemFieldOperation

Work Item Field Operation

Name Path Type Description
Name
Name string

The name of the work item field operation.

Reference Name
ReferenceName string

The reference name of the work item field operation.