Azure Devops

@adamchubbuck/azure-devopsv2026.10.28.2· MIT· 1d agoBEHAVIORS

01README

Full Azure DevOps API coverage: Git, pipelines, work items and more. Works with Azure DevOps Services, legacy visualstudio.com URLs and Server/on-prem.

02Behaviors13

@adamchubbuck/azure-devops/corev2026.10.28.1core.ts

fn listProjects(stateFilter?: enum, limit?: number)

List all projects in the organization, following continuation tokens.

Argument	Type	Required	Description
stateFilter?	enum	no	Filter by project state.
limit?	number	no	Stop after this many projects.

fn getProject(includeCapabilities?: boolean)

Get one project by name or ID, optionally with capabilities.

Argument	Type	Required	Description
includeCapabilities?	boolean	no

fn createProject(name: string, description?: string, visibility?: enum, sourceControlType?: enum, processTemplateId?: string)

Queue creation of a new project. Project creation is asynchronous; the result holds the operation reference.

Argument	Type	Required	Description
name	string	yes	New project name (e.g. 'my-project').
description?	string	no
visibility?	enum	no
sourceControlType?	enum	no
processTemplateId?	string	no	Process template ID. Defaults to the organization's default process.

fn deleteProject(projectId: string)

DESTRUCTIVE: delete a project and all of its data. Requires confirm: true.

Argument	Type	Required	Description
projectId	string	yes	Project ID (GUID).

fn listTeams(project?: string, mine?: boolean, limit?: number)

List teams. With a project, lists that project's teams; without, lists every team the caller can see in the organization.

Argument	Type	Required	Description
project?	string	no	Project name or ID. Omit to list teams across the whole organization.
mine?	boolean	no	Only teams the caller belongs to.
limit?	number	no

fn getTeam(team: string, expandIdentity?: boolean)

Get one team by name or ID within a project.

Argument	Type	Required	Description
team	string	yes	Team name or ID.
expandIdentity?	boolean	no

fn listTeamMembers(team: string, limit?: number)

List the members of a team.

Argument	Type	Required	Description
team	string	yes	Team name or ID.
limit?	number	no

fn createTeam(name: string, description?: string)

Create a team in a project.

Argument	Type	Required	Description
name	string	yes	Team name (e.g. 'my-team').
description?	string	no

fn updateTeam(team: string, name?: string, description?: string)

Rename a team or change its description.

Argument	Type	Required	Description
team	string	yes	Current team name or ID.
name?	string	no
description?	string	no

fn deleteTeam(team: string)

DESTRUCTIVE: delete a team. Requires confirm: true.

Argument	Type	Required	Description
team	string	yes	Team name or ID.

Resources

project(infinite)— A single project

projects(infinite)— List of projects

team(infinite)— A single team

teams(infinite)— List of teams or team members

result(infinite)— Outcome of a write operation

@adamchubbuck/azure-devops/gitv2026.10.28.1git.ts

fn listRepositories(includeHidden?: boolean)

List Git repositories in a project, or in the whole organization when no project is set.

Argument	Type	Required	Description
includeHidden?	boolean	no

fn getRepository()

Get one repository by name or ID.

fn createRepository(name: string)

Create a new Git repository in a project.

Argument	Type	Required	Description
name	string	yes	New repository name (e.g. 'my-repo').

fn updateRepository(repositoryId: string, name?: string, defaultBranch?: string, isDisabled?: boolean)

Rename a repository, change its default branch, or disable it.

Argument	Type	Required	Description
repositoryId	string	yes	Repository ID (GUID).
name?	string	no
defaultBranch?	string	no	e.g. 'main' or 'refs/heads/main'.
isDisabled?	boolean	no

fn deleteRepository(repositoryId: string)

DESTRUCTIVE: delete a repository (moves it to the recycle bin). Requires confirm: true.

Argument	Type	Required	Description
repositoryId	string	yes	Repository ID (GUID).

fn listBranches(filter?: string)

List branches of a repository with ahead/behind stats.

Argument	Type	Required	Description
filter?	string	no	Only branches whose name starts with this, e.g. 'feature/'.

fn listRefs(filter?: string)

List refs (branches, tags, ...) of a repository, optionally filtered, e.g. filter 'tags/'.

Argument	Type	Required	Description
filter?	string	no	Ref prefix after 'refs/'.

fn createBranch(name: string, sourceBranch?: string, commitId?: string)

Create a branch from another branch or a commit. Fails if the branch already exists.

Argument	Type	Required	Description
name	string	yes	New branch name, e.g. 'feature/x'.
sourceBranch?	string	no	Branch to branch from, e.g. 'main'. Ignored when commitId is set.
commitId?	string	no	Commit SHA to branch from.

fn deleteBranch(name: string)

DESTRUCTIVE: delete a branch. Requires confirm: true.

Argument	Type	Required	Description
name	string	yes	Branch name, e.g. 'feature/x'.

fn forceUpdateBranch(name: string, newCommitId: string)

DESTRUCTIVE: force-move a branch to a commit, discarding commits not reachable from it. Requires confirm: true.

Argument	Type	Required	Description
name	string	yes	Branch name.
newCommitId	string	yes	Commit SHA the branch should point to.

fn listCommits(branch?: string, path?: string, author?: string, fromDate?: string, toDate?: string, limit?: number)

List commits on a branch, optionally filtered by path, author or dates.

Argument	Type	Required	Description
branch?	string	no	Branch name, e.g. 'main'.
path?	string	no	Only commits touching this path.
author?	string	no
fromDate?	string	no	ISO date.
toDate?	string	no	ISO date.
limit?	number	no

fn getCommit(commitId: string, changeCount?: number)

Get one commit by SHA, optionally with change counts.

Argument	Type	Required	Description
commitId	string	yes
changeCount?	number	no

fn listPushes(branch?: string, limit?: number)

List pushes to a repository, optionally for one branch.

Argument	Type	Required	Description
branch?	string	no
limit?	number	no

fn getPush(pushId: number)

Get one push by ID, including its commits.

Argument	Type	Required	Description
pushId	number	yes

fn createPush(branch: string, message: string, changes: array)

Push one commit that adds, edits or deletes files on a branch. Creates the branch when it does not exist. Never force-pushes: fails if the branch moved.

Argument	Type	Required	Description
branch	string	yes	Target branch, e.g. 'feature/x'.
message	string	yes	Commit message.
changes	array	yes

fn listPullRequests(repository?: string, status?: enum, sourceBranch?: string, targetBranch?: string, creatorId?: string, reviewerId?: string, limit?: number)

List pull requests in a repository (or the whole project when no repository is given).

Argument	Type	Required
repository?	string	no
status?	enum	no
sourceBranch?	string	no
targetBranch?	string	no
creatorId?	string	no
reviewerId?	string	no
limit?	number	no

fn getPullRequest(repository?: string)

Get one pull request by ID.

Argument	Type	Required	Description
repository?	string	no	Optional; the ID alone is enough within a project.

fn createPullRequest(sourceBranch: string, targetBranch: string, title: string, description?: string, isDraft?: boolean, reviewerIds?: array, labels?: array, workItemIds?: array)

Create a pull request, e.g. from 'feature/x' into 'main'. Reuses nothing: fails if an active PR for the same branches exists.

Argument	Type	Required	Description
sourceBranch	string	yes	e.g. 'feature/x'
targetBranch	string	yes	e.g. 'main'
title	string	yes
description?	string	no
isDraft?	boolean	no
reviewerIds?	array	no	Identity IDs of reviewers to add.
labels?	array	no
workItemIds?	array	no	Work items to link.

fn updatePullRequest(title?: string, description?: string, targetBranch?: string, isDraft?: boolean)

Update a pull request's title, description, target branch or draft state. Does not abandon or complete it.

Argument	Type	Required
title?	string	no
description?	string	no
targetBranch?	string	no
isDraft?	boolean	no

fn abandonPullRequest()

DESTRUCTIVE: abandon (close without merging) a pull request. Requires confirm: true.

fn completePullRequest(mergeStrategy?: enum, deleteSourceBranch?: boolean, mergeCommitMessage?: string)

DESTRUCTIVE: complete (merge) a pull request using its current source commit. Requires confirm: true.

Argument	Type	Required
mergeStrategy?	enum	no
deleteSourceBranch?	boolean	no
mergeCommitMessage?	string	no

fn listThreads()

List comment threads on a pull request.

fn createThread(content: string, status?: enum, filePath?: string, line?: number)

Start a comment thread on a pull request, general or anchored to a file line.

Argument	Type	Required	Description
content	string	yes	Markdown comment text.
status?	enum	no
filePath?	string	no	e.g. '/src/app.ts'.
line?	number	no	Line in the right (new) side of the file; requires filePath.

fn replyToThread(threadId: number, content: string, parentCommentId?: number)

Add a reply comment to an existing pull request thread.

Argument	Type	Required
threadId	number	yes
content	string	yes
parentCommentId?	number	no

fn updateThreadStatus(threadId: number, status: enum)

Set a pull request thread's status, e.g. resolve it as 'fixed'.

Argument	Type	Required	Description
threadId	number	yes
status	enum	yes

fn listReviewers()

List reviewers of a pull request with their votes.

fn addReviewer(reviewerId: string, isRequired?: boolean)

Add a reviewer (user or group identity ID) to a pull request.

Argument	Type	Required	Description
reviewerId	string	yes	Identity ID (GUID).
isRequired?	boolean	no

fn setVote(vote: enum, reviewerId?: string)

Cast a vote on a pull request as the authenticated identity (or another reviewer ID).

Argument	Type	Required	Description
vote	enum	yes
reviewerId?	string	no	Defaults to the identity that owns the token.

fn removeReviewer(reviewerId: string)

DESTRUCTIVE: remove a reviewer from a pull request. Requires confirm: true.

Argument	Type	Required	Description
reviewerId	string	yes

fn listPolicyConfigurations(repositoryId?: string, branch?: string)

List branch policy configurations in a project, optionally for one repository and branch.

Argument	Type	Required	Description
repositoryId?	string	no	Repository ID (GUID).
branch?	string	no	e.g. 'main'. Requires repositoryId.

fn listPolicyEvaluations()

List branch policy evaluations (build, reviewers, comments...) for a pull request.

@adamchubbuck/azure-devops/buildv2026.10.28.1build.ts

fn listDefinitions(name?: string, path?: string)

List build definitions, optionally filtered by name or folder path.

Argument	Type	Required	Description
name?	string	no	Name filter; '*' wildcards allowed.
path?	string	no	Folder path, e.g. '\\\\my-folder'.

fn getDefinition(definitionId: number, revision?: number)

Get one build definition, including its process and triggers.

Argument	Type	Required	Description
definitionId	number	yes
revision?	number	no

fn deleteDefinition(definitionId: number)

DESTRUCTIVE: delete a build definition and its builds. Requires confirm: true.

Argument	Type	Required	Description
definitionId	number	yes

fn listBuilds(definitionIds?: array, branch?: string, statusFilter?: enum, resultFilter?: enum)

List builds, filtered by definition, branch, status or result.

Argument	Type	Required	Description
definitionIds?	array	no
branch?	string	no	e.g. 'main'.
statusFilter?	enum	no
resultFilter?	enum	no

fn getBuild()

Get one build by ID.

fn queueBuild(definitionId: number, branch?: string, parameters?: record)

DESTRUCTIVE (starts work and may deploy): queue a new build of a definition. Requires confirm: true.

Argument	Type	Required	Description
definitionId	number	yes
branch?	string	no	e.g. 'main'. Defaults to the definition's default branch.
parameters?	record	no	Queue-time variables.

fn cancelBuild()

DESTRUCTIVE: cancel a running build. Requires confirm: true.

fn listLogs()

List the log files of a build.

fn getLog(logId: number, startLine?: number, endLine?: number)

Download one build log as a text file (optionally a line range).

Argument	Type	Required
logId	number	yes
startLine?	number	no
endLine?	number	no

fn listArtifacts()

List artifacts published by a build.

Files

log(text/plain)— Plain text build log

@adamchubbuck/azure-devops/pipelinesv2026.10.28.1pipelines.ts

fn listPipelines(orderBy?: string, limit?: number)

List YAML and classic pipelines in a project.

Argument	Type	Required	Description
orderBy?	string	no	e.g. 'name asc'.
limit?	number	no

fn getPipeline(pipelineVersion?: number)

Get one pipeline by ID.

Argument	Type	Required	Description
pipelineVersion?	number	no

fn listRuns()

List runs of a pipeline, newest first.

fn getRun()

Get one pipeline run with its state, result and resources.

fn runPipeline(branch?: string, templateParameters?: record, variables?: record)

DESTRUCTIVE (starts work and may deploy): queue a new run of a pipeline. Requires confirm: true.

Argument	Type	Required	Description
branch?	string	no	e.g. 'main'.
templateParameters?	record	no
variables?	record	no

fn listRunLogs()

List log files of a pipeline run, with signed download URLs.

@adamchubbuck/azure-devops/workitemsv2026.10.28.1workitems.ts

fn getWorkItem(asOf?: string)

Get one work item by ID.

Argument	Type	Required	Description
asOf?	string	no	ISO date for a historic view.

fn getWorkItems(ids: array)

Get many work items by ID. IDs are fetched in chunks of 200 (the API limit).

Argument	Type	Required	Description
ids	array	yes

fn createWorkItem(type: string, fields: record, validateOnly?: boolean, bypassRules?: boolean, suppressNotifications?: boolean)

Create a work item of the given type (e.g. 'Bug', 'User Story') from a field record.

Argument	Type	Required	Description
type	string	yes	Work item type name.
fields	record	yes	Field reference name -> value, e.g. {'System.Title': 'Fix it'}.
validateOnly?	boolean	no
bypassRules?	boolean	no
suppressNotifications?	boolean	no

fn updateWorkItem(operations: array, validateOnly?: boolean, bypassRules?: boolean, suppressNotifications?: boolean)

Update a work item with JSON Patch operations (add/replace/remove/test).

Argument	Type	Required
operations	array	yes
validateOnly?	boolean	no
bypassRules?	boolean	no
suppressNotifications?	boolean	no

fn deleteWorkItem(destroy?: boolean)

DESTRUCTIVE: delete a work item (recycle bin) or permanently destroy it with destroy: true. Requires confirm: true.

Argument	Type	Required	Description
destroy?	boolean	no	Permanently destroy instead of moving to the recycle bin.

fn runWiql(query: string, top?: number, hydrate?: boolean)

Run a WIQL query (read-only). Returns ids; set hydrate: true to also fetch the work items (in chunks of 200).

Argument	Type	Required	Description
query	string	yes	WIQL, e.g. 'SELECT [System.Id] ...
top?	number	no	Maximum rows (server default limit is 20000).
hydrate?	boolean	no

fn getQuery(queryIdOrPath: string, depth?: number, expand?: enum)

Get a saved query or folder by ID or path.

Argument	Type	Required	Description
queryIdOrPath	string	yes	Query GUID or path, e.g. 'Shared Queries/My Query'.
depth?	number	no
expand?	enum	no

fn listQueries(depth?: number, expand?: enum, includeDeleted?: boolean)

List the saved query and folder tree (My/Shared Queries).

Argument	Type	Required
depth?	number	no
expand?	enum	no
includeDeleted?	boolean	no

fn listWorkItemTypes()

List work item types of a project.

fn getWorkItemType(type: string)

Get one work item type (states, fields, transitions).

Argument	Type	Required	Description
type	string	yes	e.g. 'Bug'.

fn listFields(expand?: enum)

List work item fields (project-scoped when a project is set).

Argument	Type	Required	Description
expand?	enum	no

fn listComments(top?: number, order?: enum, includeDeleted?: boolean)

List comments of a work item (7.2-preview.4).

Argument	Type	Required
top?	number	no
order?	enum	no
includeDeleted?	boolean	no

fn addComment(text: string)

Add a comment to a work item (7.2-preview.4).

Argument	Type	Required	Description
text	string	yes	Comment text (HTML allowed).

fn listRevisions(top?: number, skip?: number)

List the revisions (full snapshots) of a work item.

Argument	Type	Required	Description
top?	number	no
skip?	number	no

fn listUpdates(top?: number, skip?: number)

List the field-level updates (deltas) of a work item.

Argument	Type	Required	Description
top?	number	no
skip?	number	no

fn addLink(rel: string, targetId?: number, url?: string, comment?: string)

Add a relation to a work item, e.g. rel 'System.LinkTypes.Hierarchy-Reverse' (parent) with the target work item ID or a full URL.

Argument	Type	Required	Description
rel	string	yes	Link type reference name.
targetId?	number	no	Target work item ID (the URL is built for you).
url?	string	no	Explicit target URL (PRs, commits, hyperlinks). Overrides targetId.
comment?	string	no

fn removeLink(targetId?: number, url?: string, rel?: string)

DESTRUCTIVE: remove a relation from a work item, matched by its URL (or target work item ID) and optional rel. Requires confirm: true.

Argument	Type	Required	Description
targetId?	number	no
url?	string	no
rel?	string	no	Restrict the match to this link type.

fn listAreas(depth?: number)

Get the area path tree of a project.

Argument	Type	Required	Description
depth?	number	no

fn listIterations(depth?: number)

Get the iteration path tree of a project.

Argument	Type	Required	Description
depth?	number	no

fn listTags()

List work item tags used in a project.

@adamchubbuck/azure-devops/testv2026.10.28.1test.ts

fn listTestPlans(owner?: string, filterActivePlans?: boolean, includePlanDetails?: boolean)

List test plans of a project.

Argument	Type	Required	Description
owner?	string	no	Filter by owner.
filterActivePlans?	boolean	no
includePlanDetails?	boolean	no

fn getTestPlan()

Get one test plan by ID.

fn listTestSuites(expand?: enum, asTreeView?: boolean)

List the test suites of a test plan.

Argument	Type	Required	Description
expand?	enum	no
asTreeView?	boolean	no

fn listTestCases(witFields?: array)

List the test cases in a suite of a test plan.

Argument	Type	Required	Description
witFields?	array	no	Work item fields to include, e.g. ['System.Title'].

fn listTestPoints(testCaseId?: string, includePointDetails?: boolean)

List the test points (case x configuration) of a suite.

Argument	Type	Required	Description
testCaseId?	string	no	Filter by test case ID.
includePointDetails?	boolean	no

fn listTestRuns(planId?: number, buildUri?: string, automated?: boolean, includeRunDetails?: boolean)

List test runs, optionally filtered by plan or build.

Argument	Type	Required	Description
planId?	number	no
buildUri?	string	no	e.g. 'vstfs:///Build/Build/123'.
automated?	boolean	no
includeRunDetails?	boolean	no

fn getTestRun(includeDetails?: boolean)

Get one test run with its statistics.

Argument	Type	Required	Description
includeDetails?	boolean	no

fn createTestRun(name: string, planId?: number, pointIds?: array, automated?: boolean, buildId?: number, state?: enum, comment?: string)

Create a test run record (planned or automated) to which results can be posted. Does not execute any tests.

Argument	Type	Required	Description
name	string	yes
planId?	number	no
pointIds?	array	no	Test point IDs to include (planned runs).
automated?	boolean	no
buildId?	number	no
state?	enum	no
comment?	string	no

fn listTestResults(outcomes?: array, detailsToInclude?: enum)

List the results of a test run.

Argument	Type	Required	Description
outcomes?	array	no	e.g. ['Failed','Aborted'].
detailsToInclude?	enum	no

fn getTestResult(resultId: number, detailsToInclude?: enum)

Get one test result of a run.

Argument	Type	Required	Description
resultId	number	yes
detailsToInclude?	enum	no

fn updateTestResults(results: array)

Update (e.g. set outcome/state of) existing test results in a run. Each entry must include the result 'id'.

Argument	Type	Required	Description
results	array	yes	e.g. [{id: 100000, outcome: 'Passed', state: 'Completed'}].

fn getCodeCoverageSummary(deltaBuildId?: number)

Get the code coverage summary of a build (preview API).

Argument	Type	Required	Description
deltaBuildId?	number	no	Compare against this build.

fn listTestResultsByBuild(publishContext?: string, outcomes?: array)

List test results of a build (preview API).

Argument	Type	Required	Description
publishContext?	string	no	e.g. 'CI' or 'PR'.
outcomes?	array	no

@adamchubbuck/azure-devops/releasev2026.10.28.1release.ts

fn listDefinitions(searchText?: string, path?: string, expand?: string, limit?: number)

List classic release definitions in a project.

Argument	Type	Required	Description
searchText?	string	no
path?	string	no	Folder path, e.g. '\\\\'.
expand?	string	no	e.g. 'environments,artifacts,triggers'.
limit?	number	no

fn getDefinition()

Get one release definition, including its stages.

fn getReleaseDefinitionHistory()

List the revision history of a release definition.

fn listReleases(definitionId?: number, definitionEnvironmentId?: number, statusFilter?: enum, environmentStatusFilter?: number, createdBy?: string, minCreatedTime?: string, maxCreatedTime?: string, queryOrder?: enum, searchText?: string, sourceBranchFilter?: string, expand?: string, top?: number, nextPageToken?: string)

List one page of releases with filters. Pass the returned nextPageToken back as nextPageToken to fetch the next page.

Argument	Type	Required	Description
definitionId?	number	no
definitionEnvironmentId?	number	no
statusFilter?	enum	no
environmentStatusFilter?	number	no
createdBy?	string	no
minCreatedTime?	string	no	ISO 8601 date-time.
maxCreatedTime?	string	no	ISO 8601 date-time.
queryOrder?	enum	no
searchText?	string	no
sourceBranchFilter?	string	no
expand?	string	no	e.g. 'environments,artifacts'.
top?	number	no
nextPageToken?	string	no	Cursor returned as nextPageToken by a previous call.

fn getRelease(expand?: string)

Get one release with its environments and artifacts.

Argument	Type	Required	Description
expand?	string	no	e.g. 'tags'.

fn createRelease(description?: string, artifacts?: array, manualEnvironments?: array, isDraft?: boolean)

DESTRUCTIVE (may trigger automatic deployments): create a release from a definition. Requires confirm: true.

Argument	Type	Required	Description
description?	string	no
artifacts?	array	no	Artifact versions to pin.
manualEnvironments?	array	no	Stage names that must start manually instead of automatically.
isDraft?	boolean	no

fn updateReleaseEnvironment(status: enum, comment?: string, scheduledDeploymentTime?: string, variables?: record)

DESTRUCTIVE (can start, cancel or reject a deployment): update the status of a release environment. Requires confirm: true.

Argument	Type	Required	Description
status	enum	yes
comment?	string	no
scheduledDeploymentTime?	string	no	ISO 8601 date-time; used with status 'scheduled'.
variables?	record	no	Variable overrides for this deployment.

fn startDeployment(comment?: string, variables?: record)

DESTRUCTIVE (deploys): start deployment of a release environment (status inProgress). Requires confirm: true.

Argument	Type	Required	Description
comment?	string	no
variables?	record	no

fn listApprovals(statusFilter?: enum, assignedToFilter?: string, releaseIdsFilter?: array, typeFilter?: enum, limit?: number)

List release approvals, e.g. pending ones for a release.

Argument	Type	Required	Description
statusFilter?	enum	no
assignedToFilter?	string	no	Display name or unique name of the approver.
releaseIdsFilter?	array	no
typeFilter?	enum	no
limit?	number	no

fn updateApproval(approvalId: number, decision: enum, comment?: string)

DESTRUCTIVE (approving lets a deployment proceed): approve or reject a release approval with a comment. Requires confirm: true.

Argument	Type	Required
approvalId	number	yes
decision	enum	yes
comment?	string	no

fn getReleaseLog(releasePhaseId: number, taskId: number, startLine?: number, endLine?: number)

Get the log text of one task in a release environment.

Argument	Type	Required	Description
releasePhaseId	number	yes	Deploy phase ID (releaseDeployPhases[].id).
taskId	number	yes	Task ID (deploymentJobs[].tasks[].id).
startLine?	number	no
endLine?	number	no

fn listDeployments(definitionId?: number, definitionEnvironmentId?: number, deploymentStatus?: enum, operationStatus?: string, minStartedTime?: string, maxStartedTime?: string, limit?: number)

List deployments, optionally for one definition or stage.

Argument	Type	Required	Description
definitionId?	number	no
definitionEnvironmentId?	number	no
deploymentStatus?	enum	no
operationStatus?	string	no	e.g. 'QueuedForAgent', 'Approved'.
minStartedTime?	string	no	ISO 8601 date-time.
maxStartedTime?	string	no	ISO 8601 date-time.
limit?	number	no

fn abandonRelease(comment?: string)

DESTRUCTIVE: abandon a release so it can no longer be deployed. Requires confirm: true.

Argument	Type	Required	Description
comment?	string	no

fn deleteDefinition(comment?: string, forceDelete?: boolean)

DESTRUCTIVE: permanently delete a release definition. Requires confirm: true.

Argument	Type	Required	Description
comment?	string	no
forceDelete?	boolean	no	Also delete when releases still exist.

@adamchubbuck/azure-devops/artifactsv2026.10.28.1artifacts.ts

fn listFeeds(feedRole?: enum, includeDeletedUpstreams?: boolean)

List Azure Artifacts feeds visible to the caller.

Argument	Type	Required	Description
feedRole?	enum	no
includeDeletedUpstreams?	boolean	no

fn getFeed()

Get one feed by name or ID.

fn createFeed(name: string, description?: string, upstreamEnabled?: boolean, hideDeletedPackageVersions?: boolean)

DESTRUCTIVE (creates a shared resource): create a feed. Requires confirm: true.

Argument	Type	Required	Description
name	string	yes
description?	string	no
upstreamEnabled?	boolean	no	Enable upstream sources (public registries).
hideDeletedPackageVersions?	boolean	no

fn deleteFeed()

DESTRUCTIVE: delete a feed and all packages in it. Requires confirm: true.

fn listPackages(protocolType?: string, packageNameQuery?: string, includeAllVersions?: boolean, includeDeleted?: boolean, view?: string, limit?: number)

List packages in a feed with optional filters.

Argument	Type	Required	Description
protocolType?	string	no	e.g. 'NuGet', 'Npm', 'Maven', 'PyPI', 'UPack'.
packageNameQuery?	string	no	Substring of the package name.
includeAllVersions?	boolean	no
includeDeleted?	boolean	no
view?	string	no	Feed view name or ID, e.g. 'Release'.
limit?	number	no

fn getPackage(packageId: string, includeAllVersions?: boolean)

Get one package (by package ID) from a feed.

Argument	Type	Required	Description
packageId	string	yes	Package ID (GUID) from listPackages.
includeAllVersions?	boolean	no

fn listPackageVersions(packageId: string, includeUrls?: boolean, isListed?: boolean, isDeleted?: boolean)

List versions of a package.

Argument	Type	Required
packageId	string	yes
includeUrls?	boolean	no
isListed?	boolean	no
isDeleted?	boolean	no

fn getPackageVersion(packageId: string, packageVersionId: string, showDeleted?: boolean)

Get one version of a package (by version ID).

Argument	Type	Required	Description
packageId	string	yes
packageVersionId	string	yes	Version ID (GUID) from listPackageVersions.
showDeleted?	boolean	no

fn deletePackageVersion(packageName: string, version: string)

DESTRUCTIVE: move a package version to the feed recycle bin. Requires confirm: true.

Argument	Type	Required	Description
packageName	string	yes	Package name; for maven use 'groupId:artifactId'; for npm scoped use '@scope/name'.
version	string	yes

fn promotePackageVersion(packageName: string, version: string, view: string, op?: enum)

DESTRUCTIVE (changes what consumers of a view receive): add or remove a package version in a feed view such as 'Release'. Requires confirm: true.

Argument	Type	Required	Description
packageName	string	yes
version	string	yes
view	string	yes	View name or ID, e.g. 'Release'.
op?	enum	no

fn listFeedViews()

List the views of a feed (e.g. Local, Prerelease, Release).

fn listFeedPermissions(includeIds?: boolean, excludeInheritedPermissions?: boolean, identityDescriptor?: string)

List the permissions (role assignments) of a feed.

Argument	Type	Required
includeIds?	boolean	no
excludeInheritedPermissions?	boolean	no
identityDescriptor?	string	no

fn getRetentionPolicy()

Get the retention policy of a feed.

fn listBuildArtifacts()

List the artifacts published by a build (normal host).

fn getBuildArtifact(artifactName: string)

Get one named artifact of a build, with its download URL.

Argument	Type	Required	Description
artifactName	string	yes

@adamchubbuck/azure-devops/graphv2026.10.28.1graph.ts

fn listUsers(subjectTypes?: string, scopeDescriptor?: string)

List users in the organization (Graph, preview).

Argument	Type	Required	Description
subjectTypes?	string	no	Comma-separated, e.g. 'aad,msa,vsts'.
scopeDescriptor?	string	no

fn getUser()

Get one user by descriptor.

fn listGroups(scopeDescriptor?: string, subjectTypes?: string)

List groups in the organization or a scope.

Argument	Type	Required	Description
scopeDescriptor?	string	no	Restrict to a project scope descriptor.
subjectTypes?	string	no

fn getGroup()

Get one group by descriptor.

fn createGroup(displayName: string, description?: string, scopeDescriptor?: string, groupDescriptors?: array)

DESTRUCTIVE (changes access control): create a VSTS group, optionally scoped to a project. Requires confirm: true.

Argument	Type	Required	Description
displayName	string	yes
description?	string	no
scopeDescriptor?	string	no	Project scope descriptor; omit for an organization-level group.
groupDescriptors?	array	no	Parent groups the new group should join.

fn deleteGroup()

DESTRUCTIVE: delete a VSTS group by descriptor. Requires confirm: true.

fn listMemberships(direction?: enum, depth?: number)

List memberships of a subject: containers it belongs to (up) or members it contains (down).

Argument	Type	Required	Description
direction?	enum	no
depth?	number	no

fn addMembership()

DESTRUCTIVE (grants access): add a subject to a container group. Requires confirm: true.

fn removeMembership()

DESTRUCTIVE (revokes access): remove a subject from a container group. Requires confirm: true.

fn getDescriptor(storageKey: string)

Resolve a storage key (GUID) to its Graph descriptor.

Argument	Type	Required	Description
storageKey	string	yes	Storage key GUID.

fn listDescriptors(storageKeys: array)

Resolve several storage keys to descriptors (one call per key, results merged).

Argument	Type	Required	Description
storageKeys	array	yes

fn getStorageKey()

Resolve a Graph descriptor to its storage key (GUID).

fn lookupSubjects(descriptors: array)

Look up multiple subjects by descriptor in one call.

Argument	Type	Required	Description
descriptors	array	yes

fn searchIdentities(searchFilter?: enum, filterValue: string, queryMembership?: enum)

Search identities (users/groups) by display name, account name or mail address.

Argument	Type	Required
searchFilter?	enum	no
filterValue	string	yes
queryMembership?	enum	no

@adamchubbuck/azure-devops/securityv2026.10.28.1security.ts

fn listSecurityNamespaces(localOnly?: boolean)

List security namespaces, their actions and bit values.

Argument	Type	Required	Description
localOnly?	boolean	no

fn getSecurityNamespace()

Get one security namespace (including its actions).

fn listAccessControlLists(descriptors?: string, includeExtendedInfo?: boolean, recurse?: boolean)

List access control lists in a namespace.

Argument	Type	Required	Description
descriptors?	string	no	Comma-separated identity descriptors to filter by.
includeExtendedInfo?	boolean	no
recurse?	boolean	no

fn queryAccessControlEntries(descriptors?: string, includeExtendedInfo?: boolean)

Query the access control entries (ACEs) on one token, flattened from its ACL.

Argument	Type	Required	Description
descriptors?	string	no
includeExtendedInfo?	boolean	no

fn setAccessControlEntries(merge?: boolean, accessControlEntries: array)

DESTRUCTIVE (changes permissions): add or replace ACEs on a token. Requires confirm: true.

Argument	Type	Required	Description
merge?	boolean	no	Merge bits into existing ACEs (true) or replace them (false).
accessControlEntries	array	yes

fn removeAccessControlEntries(descriptors: array)

DESTRUCTIVE (revokes permissions): remove the ACEs of given identities from a token. Requires confirm: true.

Argument	Type	Required	Description
descriptors	array	yes

fn hasPermissions(permissions: number, tokens?: array, alwaysAllowAdministrators?: boolean, descriptor?: string)

Check whether the caller (or given identity) has a permission bitmask on tokens in a namespace.

Argument	Type	Required	Description
permissions	number	yes	Permission bitmask to check (use 0 to omit).
tokens?	array	no
alwaysAllowAdministrators?	boolean	no
descriptor?	string	no	Check for this identity instead of the caller.

@adamchubbuck/azure-devops/wikiv2026.10.28.1wiki.ts

fn listWikis()

List wikis in a project (or the whole organization).

fn getWiki()

Get one wiki by ID or name.

fn createWiki(name: string, type?: enum, projectId?: string, repositoryId?: string, mappedPath?: string, version?: string)

DESTRUCTIVE (creates a wiki): create a project wiki or publish a code wiki from a repository folder. Requires confirm: true.

Argument	Type	Required	Description
name	string	yes
type?	enum	no
projectId?	string	no	Project ID (GUID); required by the API for both wiki types.
repositoryId?	string	no	Required for codeWiki.
mappedPath?	string	no	Repo folder published as the wiki (codeWiki).
version?	string	no	Branch to publish (codeWiki), e.g. 'main'.

fn deleteWiki()

DESTRUCTIVE: delete a wiki (and its content for project wikis). Requires confirm: true.

fn listPages(pageViewsForDays?: number, limit?: number)

List pages of a wiki (batch API; page metadata only).

Argument	Type	Required	Description
pageViewsForDays?	number	no
limit?	number	no

fn getPage(includeContent?: boolean, recursionLevel?: enum)

Get a wiki page by path, optionally with its content.

Argument	Type	Required	Description
includeContent?	boolean	no
recursionLevel?	enum	no

fn getPageById(includeContent?: boolean)

Get a wiki page by numeric ID, optionally with content.

Argument	Type	Required	Description
includeContent?	boolean	no

fn createOrUpdatePage(content: string, comment?: string, etag?: string)

DESTRUCTIVE (writes content): create a page, or update an existing one by supplying its current ETag (sent as If-Match). Requires confirm: true.

Argument	Type	Required	Description
content	string	yes	Markdown content of the page.
comment?	string	no	Edit comment.
etag?	string	no	Current ETag of the page; required to update an existing page, omit to create.

fn deletePage(comment?: string)

DESTRUCTIVE: delete a wiki page (and its subpages) by path. Requires confirm: true.

Argument	Type	Required	Description
comment?	string	no

fn getPageStats(pageViewsForDays?: number)

Get view statistics of a wiki page.

Argument	Type	Required	Description
pageViewsForDays?	number	no

@adamchubbuck/azure-devops/dashboardsv2026.10.28.1dashboards.ts

fn listDashboards()

List dashboards of a team.

fn getDashboard()

Get a dashboard with its widgets.

fn createDashboard(name: string, description?: string, refreshInterval?: number, widgets?: array)

DESTRUCTIVE (creates content): create a dashboard for a team. Requires confirm: true.

Argument	Type	Required	Description
name	string	yes
description?	string	no
refreshInterval?	number	no	Auto-refresh interval in minutes (0 = off).
widgets?	array	no

fn updateDashboard(name: string, description?: string, refreshInterval?: number, widgets?: array)

DESTRUCTIVE (replaces content): replace a dashboard definition (name, description, widgets). Requires confirm: true.

Argument	Type	Required
name	string	yes
description?	string	no
refreshInterval?	number	no
widgets?	array	no

fn deleteDashboard()

DESTRUCTIVE: delete a dashboard. Requires confirm: true.

fn listWidgets()

List widgets on a dashboard.

fn getWidget()

Get one widget on a dashboard.

fn addWidget()

DESTRUCTIVE (modifies dashboard): add a widget to a dashboard. Requires confirm: true.

fn updateWidget()

DESTRUCTIVE (modifies dashboard): replace a widget definition. Requires confirm: true.

fn deleteWidget()

DESTRUCTIVE: delete a widget from a dashboard. Requires confirm: true.

fn listWidgetTypes(scope?: enum)

List widget types available in the project.

Argument	Type	Required	Description
scope?	enum	no

@adamchubbuck/azure-devops/servicehooksv2026.10.28.1servicehooks.ts

fn listPublishers()

List service hook publishers (event sources).

fn listConsumers()

List service hook consumers (targets).

fn getConsumer(consumerId: string)

Get one consumer and its input descriptors.

Argument	Type	Required	Description
consumerId	string	yes

fn listConsumerActions(consumerId: string)

List the actions of a consumer.

Argument	Type	Required	Description
consumerId	string	yes

fn listEventTypes(publisherId: string)

List the event types of a publisher.

Argument	Type	Required	Description
publisherId	string	yes	e.g. 'tfs'.

fn listSubscriptions(publisherId?: string, eventType?: string, consumerId?: string, consumerActionId?: string)

List subscriptions, optionally filtered.

Argument	Type	Required
publisherId?	string	no
eventType?	string	no
consumerId?	string	no
consumerActionId?	string	no

fn getSubscription()

Get one subscription.

fn createSubscription()

DESTRUCTIVE (starts sending events to an external target): create a subscription. Secret consumer inputs go in secretConsumerInputs. Requires confirm: true.

fn replaceSubscription()

DESTRUCTIVE: replace an existing subscription definition. Requires confirm: true.

fn deleteSubscription()

DESTRUCTIVE: delete a subscription. Requires confirm: true.

fn testSubscription()

DESTRUCTIVE (sends a test event to the external target): send a test notification for an existing subscription. Requires confirm: true.

fn listNotifications(status?: string, result?: string, maxResults?: number)

List delivery notifications of a subscription.

Argument	Type	Required	Description
status?	string	no	e.g. 'failed', 'processing', 'queued', 'completed'.
result?	string	no	e.g. 'succeeded', 'failed', 'pending'.
maxResults?	number	no

fn getNotification(notificationId: number)

Get one notification, including request/response details.

Argument	Type	Required	Description
notificationId	number	yes

fn queryNotifications(subscriptionIds?: array, status?: string, result?: string, publisherId?: string, eventType?: string, minCreatedDate?: string, maxCreatedDate?: string, maxResults?: number)

Query notifications across subscriptions by filter.

Argument	Type	Required	Description
subscriptionIds?	array	no
status?	string	no
result?	string	no
publisherId?	string	no
eventType?	string	no
minCreatedDate?	string	no	ISO 8601.
maxCreatedDate?	string	no	ISO 8601.
maxResults?	number	no