Azure DevOps Toolkit

The Azure DevOps Toolkit is a workflow node. Its tools include List Projects, Get Project, Search Work Items, Get Work Item, plus 9 more listed below. Create a connection before you use any of these tools. Type @ in a field when the value should come from an earlier step.

Authentication

Create an Azure DevOps connection before you use any of these tools.

Create a personal access token

1. In Azure DevOps, open User settings, then Personal access tokens, then New Token.
2. Grant Work Items (Read), Code (Read), Project and Team (Read), and Analytics (Read).
3. Copy the token. Azure DevOps shows it only once.

Connect the token in EKB

1. On the first Azure DevOps node, open Connection.
2. Click + New.
3. Enter a Connection Name.
4. Paste the Personal Access Token (PAT).
5. Enter the Organization name, such as my-company, or the full URL https://dev.azure.com/my-company.
6. Select the new connection in Select saved connection.

Enter token manually saves the same credentials on that node instead of a saved connection.

Tools

List Projects

List projects in the Azure DevOps organization.

Get Project

Get one project by ID or name.

Field	Required	Description
Project ID Or Name	Yes	Project ID or name to retrieve. Type @ to select a variable.

Search Work Items

Search work items with a WIQL query or a text term.

Field	Required	Description
Project	Yes	Project name or ID to search within. Type @ to select a variable.
Query	Yes	WIQL query or text search term. Type @ to select a variable.
Top	No	Maximum number of results (default 20, max 200). Type @ to select a variable.

Get Work Item

Get one work item, including its fields.

Field	Required	Description
Work Item ID	Yes	The numeric work item ID. Type @ to select a variable.
Project	No	Optional project name (used for URL routing). Type @ to select a variable.
Expand	No	Expand options: 'relations', 'all', 'fields', 'links', 'none'. Type @ to select a variable.

List Work Item Updates

List recent updates to a work item.

Field	Required	Description
Work Item ID	Yes	The numeric work item ID. Type @ to select a variable.
Top	No	Maximum number of updates (default 10). Type @ to select a variable.

List Repos

List Git repositories in a project.

Field	Required	Description
Project	Yes	Project name or ID. Type @ to select a variable.

List Branches

List branches in a repository.

Field	Required	Description
Project	Yes	Project name or ID. Type @ to select a variable.
Repo ID	Yes	Repository ID or name. Type @ to select a variable.

Get File Content

Read a file from a repository branch.

Field	Required	Description
Project	Yes	Project name or ID. Type @ to select a variable.
Repo ID	Yes	Repository ID or name. Type @ to select a variable.
Path	Yes	File path in the repository. Type @ to select a variable.
Branch	No	Branch name (default: 'main'). Type @ to select a variable.

Search Code

Search code in a project's repositories.

Field	Required	Description
Project	Yes	Project name or ID. Type @ to select a variable.
Search Text	Yes	Text to search for in code files. Type @ to select a variable.
Repo ID	No	Optional: restrict to a specific repository. Type @ to select a variable.
Top	No	Maximum number of results (default 20). Type @ to select a variable.

List Wikis

List wikis in a project.

Field	Required	Description
Project	Yes	Project name or ID. Type @ to select a variable.

Get Wiki Page

Read a wiki page.

Field	Required	Description
Project	Yes	Project name or ID. Type @ to select a variable.
Wiki ID	Yes	Wiki ID or name. Type @ to select a variable.
Path	No	Page path (default: root '/'). Type @ to select a variable.

List Iterations

List sprint iterations for a project or team.

Field	Required	Description
Project	Yes	Project name or ID. Type @ to select a variable.
Team	No	Team name (optional). Type @ to select a variable.

List Area Paths

List area paths in a project.

Field	Required	Description
Project	Yes	Project name or ID. Type @ to select a variable.

Related

See all integrations on the toolkits overview.