> **Building with AI coding agents?** Install the authstack plugin with one command. This equips your agent with accurate Scalekit implementation patterns.
>
> **Recommended** (the `-y` flags skip prompts, so the command runs without an interactive terminal):
> ```bash
> npx -y @scalekit-inc/cli setup -y
> ```
>
> Global:
> ```bash
> npm install -g @scalekit-inc/cli
> scalekit setup -y
> ```
>
> Supports Claude Code, Cursor, GitHub Copilot, Codex + skills for other Agent Skills-compatible agents in `~/.agents/skills`.
> Skills: integrate-agentkit, implement-saaskit, add-mcp-oauth, implement-sso, implement-scim.
> [Full setup guide](https://docs.scalekit.com/dev-kit/build-with-ai/)

---

# Connect AI agents to Azure DevOps

The Azure DevOps connector lets your AI agent work with Azure DevOps. Scalekit handles authentication for every call, so your agent never handles credentials. It comes with 27 tools.

**Authentication:** Personal Access Token
**Categories:** Developer Tools, Project Management
**Tools:** 27: 19 read, 7 write, 1 destructive
**Users sign in with:** Username and password
**Built by:** Scalekit connector
**Try it:** [Playground in the Scalekit dashboard](https://app.scalekit.com/ws/signup?sk_intent=playground&provider=AZUREDEVOPS)

## Setup

1. ### Install the SDK

   **Node.js**

   ```bash
   npm install @scalekit-sdk/node dotenv
   ```

   **Python**

   ```bash
   pip install scalekit-sdk-python python-dotenv
   ```

2. ### Set your credentials

   Add your Scalekit credentials to your `.env` file. Find values in **[app.scalekit.com](https://app.scalekit.com)** > **Developers** > **API Credentials**.

   ```sh title=".env"
   SCALEKIT_ENVIRONMENT_URL=<your-environment-url>
   SCALEKIT_CLIENT_ID=<your-client-id>
   SCALEKIT_CLIENT_SECRET=<your-client-secret>
   ```

3. ### Create the Azure DevOps connection

   In **AgentKit > Connections**, create an Azure DevOps connection. The name you give it is the `connection_name` your code passes. See [Configure connections](/agentkit/connections/).

## Tools

Pass the exact name to `execute_tool`, with an input like each tool's example. To ask for a tool that's missing, use the [request form](https://scalekitsupport.portal.usepylon.com/forms/request-a-connector-tool).

**Node.js**

```typescript
const result = await actions.executeTool({
  toolName: 'azuredevops_branches_list',
  toolInput: {
    project: '<project>',
    repository_id: '<repository_id>',
  },
  connector: 'azuredevops',
  identifier: 'user_123',
})
```

**Python**

```python
result = actions.execute_tool(
    tool_name="azuredevops_branches_list",
    tool_input={
        "project": "<project>",
        "repository_id": "<repository_id>",
    },
    connection_name="azuredevops",
    identifier="user_123",
)
```

`result.data` is the app's response as JSON, and `result.execution_id` (`executionId` in Node.js) is the ID of the call.

### `azuredevops_branches_list`

List Branches · Read-only

List the branches (refs) of a Git repository.
Returns each ref's name (for example refs/heads/main), objectId (commit) and creator.
Use this to find branch names for pull requests or commit history.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `project` (`string`, required): Name or ID of the Azure DevOps project. Example: Fabrikam-Fiber
- `repository_id` (`string`, required): Name or ID of the Git repository in the project. Example: fabrikam-web
- `continuation_token` (`string`, optional): Continuation token from the x-ms-continuationtoken header or continuationToken field of the previous page. Example: 5
- `filter` (`string`, optional): Only refs whose name starts with this, after refs/. Defaults to heads/ (branches); use tags/ for tags. Example: heads/feature/. Default: `heads/`.
- `filter_contains` (`string`, optional): Only refs whose name contains this text. Example: login
- `top` (`integer`, optional): Maximum number of refs to return. Example: 100

Example input: `{"project":"<project>","repository_id":"<repository_id>"}`

### `azuredevops_commits_list`

List Commits · Read-only

List commits in a Git repository, newest first, optionally on one branch, by author, for a path or in a date range.
Returns each commit's commitId, comment, author, committer and changeCounts.
Use this to review recent changes.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `project` (`string`, required): Name or ID of the Azure DevOps project. Example: Fabrikam-Fiber
- `repository_id` (`string`, required): Name or ID of the Git repository in the project. Example: fabrikam-web
- `author` (`string`, optional): Only commits by this author (name or email). Example: alex@fabrikam.com
- `branch` (`string`, optional): Branch name to list commits from, without refs/heads/. Defaults to the default branch. Example: main
- `from_date` (`string`, optional): Only commits after this date. Example: 2026-11-01T00:00:00Z
- `item_path` (`string`, optional): Only commits that touched this file or folder path. Example: /src/login
- `skip` (`integer`, optional): Number of commits to skip, for paging. Example: 50
- `to_date` (`string`, optional): Only commits before this date. Example: 2026-11-15T00:00:00Z
- `top` (`integer`, optional): Maximum number of commits to return. Example: 50

Example input: `{"project":"<project>","repository_id":"<repository_id>"}`

### `azuredevops_file_get`

Get File · Read-only

Get a file's metadata and content from a Git repository, at a branch, tag or commit.
Returns the item's path, objectId, commitId and content (text files) as JSON.
Use this to read source files or docs from a repository.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `path` (`string`, required): Path of the file in the repository, starting with /. Example: /README.md
- `project` (`string`, required): Name or ID of the Azure DevOps project. Example: Fabrikam-Fiber
- `repository_id` (`string`, required): Name or ID of the Git repository in the project. Example: fabrikam-web
- `version` (`string`, optional): Branch name, tag or commit ID to read from. Defaults to the default branch. Example: main
- `version_type` (`string`, optional): What version is: branch, tag or commit. Defaults to branch. Example: branch. One of: `branch`, `tag`, `commit`.

Example input: `{"path":"<path>","project":"<project>","repository_id":"<repository_id>"}`

### `azuredevops_pipeline_run_get`

Get Pipeline Run · Read-only

Get one run of a pipeline.
Returns its state (inProgress, completed), result (succeeded, failed, canceled), resources, templateParameters and dates.
Use this to follow a run started with azuredevops_pipeline_run.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `pipeline_id` (`integer`, required): ID of the pipeline. Get it from azuredevops_pipelines_list. Example: 12
- `project` (`string`, required): Name or ID of the Azure DevOps project. Example: Fabrikam-Fiber
- `run_id` (`integer`, required): ID of the run. Example: 1201

Example input: `{"pipeline_id":12,"project":"<project>","run_id":1201}`

### `azuredevops_pipeline_runs_list`

List Pipeline Runs · Read-only

List the most recent runs of a pipeline (up to 10,000).
Returns each run's id, name, state, result, createdDate and finishedDate.
Use this to check recent results. Use azuredevops_pipeline_run_get for one run.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `pipeline_id` (`integer`, required): ID of the pipeline. Get it from azuredevops_pipelines_list. Example: 12
- `project` (`string`, required): Name or ID of the Azure DevOps project. Example: Fabrikam-Fiber

Example input: `{"pipeline_id":12,"project":"<project>"}`

### `azuredevops_pipelines_list`

List Pipelines · Read-only

List the pipelines in an Azure DevOps project.
Returns each pipeline's id, name, folder and revision.
Use this to find a pipeline_id. Use azuredevops_pipeline_runs_list for its run history.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `project` (`string`, required): Name or ID of the Azure DevOps project. Example: Fabrikam-Fiber
- `continuation_token` (`string`, optional): Continuation token from the x-ms-continuationtoken header or continuationToken field of the previous page. Example: 5
- `order_by` (`string`, optional): Sort expression. Example: name asc
- `top` (`integer`, optional): Maximum number of pipelines to return. Example: 100

Example input: `{"project":"<project>"}`

### `azuredevops_project_get`

Get Project · Read-only

Get one Azure DevOps project by name or ID.
Returns the project's id, name, description, state, visibility and default team; with include_capabilities, also its process template and version control type.
Use this when you know the project. Use azuredevops_projects_list to browse.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `project` (`string`, required): Name or ID of the Azure DevOps project. Example: Fabrikam-Fiber
- `include_capabilities` (`boolean`, optional): Include the process template and source control capabilities. Example: true

Example input: `{"project":"<project>"}`

### `azuredevops_projects_list`

List Projects · Read-only

List the projects in the Azure DevOps organization.
Returns each project's id, name, description, state and visibility, plus a continuation token header when there are more.
Use this to find a project name. Use azuredevops_project_get for one project's details.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `continuation_token` (`string`, optional): Continuation token from the x-ms-continuationtoken header or continuationToken field of the previous page. Example: 5
- `skip` (`integer`, optional): Number of projects to skip, for paging. Example: 50
- `state_filter` (`string`, optional): Only return projects in this state: wellFormed (default), createPending, deleting, new or all. Example: wellFormed. One of: `wellFormed`, `createPending`, `deleting`, `new`, `all`.
- `top` (`integer`, optional): Maximum number of projects to return. Example: 100

Example input: `{}`

### `azuredevops_pull_request_get`

Get Pull Request · Read-only

Get one pull request in a Git repository.
Returns its title, description, status, mergeStatus, sourceRefName, targetRefName, reviewers and votes, and optionally linked work items and commits.
Use this for one pull request's details. Use azuredevops_pull_request_threads_list for its comments.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `project` (`string`, required): Name or ID of the Azure DevOps project. Example: Fabrikam-Fiber
- `pull_request_id` (`integer`, required): ID of the pull request. Example: 17
- `repository_id` (`string`, required): Name or ID of the Git repository in the project. Example: fabrikam-web
- `include_commits` (`boolean`, optional): Include the pull request's commits. Example: false
- `include_work_item_refs` (`boolean`, optional): Include the linked work items. Example: true

Example input: `{"project":"<project>","pull_request_id":17,"repository_id":"<repository_id>"}`

### `azuredevops_pull_request_threads_list`

List Pull Request Threads · Read-only

List the comment threads on a pull request.
Returns each thread's id, status, threadContext (file and line, for code comments) and comments with author and content.
Use this to read review feedback. Use azuredevops_pull_request_thread_create to comment.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `project` (`string`, required): Name or ID of the Azure DevOps project. Example: Fabrikam-Fiber
- `pull_request_id` (`integer`, required): ID of the pull request. Example: 17
- `repository_id` (`string`, required): Name or ID of the Git repository in the project. Example: fabrikam-web

Example input: `{"project":"<project>","pull_request_id":17,"repository_id":"<repository_id>"}`

### `azuredevops_pull_requests_list`

List Pull Requests · Read-only

List pull requests in a Git repository, filtered by status, branch, creator or reviewer.
Returns each pull request's pullRequestId, title, status, createdBy, sourceRefName, targetRefName, reviewers and isDraft.
Use this to browse pull requests. Use azuredevops_pull_request_get for one.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `project` (`string`, required): Name or ID of the Azure DevOps project. Example: Fabrikam-Fiber
- `repository_id` (`string`, required): Name or ID of the Git repository in the project. Example: fabrikam-web
- `creator_id` (`string`, optional): Only pull requests created by this user ID. Example: d6245f20-2af8-44f4-9451-8107cb2767db
- `reviewer_id` (`string`, optional): Only pull requests with this reviewer ID. Example: d6245f20-2af8-44f4-9451-8107cb2767db
- `skip` (`integer`, optional): Number of pull requests to skip, for paging. Example: 50
- `source_ref_name` (`string`, optional): Only pull requests from this branch. Example: refs/heads/feature/login
- `status` (`string`, optional): Pull request status: active (default), completed, abandoned or all. Example: active. One of: `active`, `completed`, `abandoned`, `all`, `notSet`.
- `target_ref_name` (`string`, optional): Only pull requests into this branch. Example: refs/heads/main
- `top` (`integer`, optional): Maximum number of pull requests to return. Example: 50

Example input: `{"project":"<project>","repository_id":"<repository_id>"}`

### `azuredevops_repositories_list`

List Repositories · Read-only

List the Git repositories in an Azure DevOps project.
Returns each repository's id, name, defaultBranch, remoteUrl, webUrl and size.
Use this to find a repository. Use azuredevops_repository_get for one repository.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `project` (`string`, required): Name or ID of the Azure DevOps project. Example: Fabrikam-Fiber

Example input: `{"project":"<project>"}`

### `azuredevops_repository_get`

Get Repository · Read-only

Get one Git repository by name or ID.
Returns its id, name, defaultBranch, remoteUrl, webUrl, size and project.
Use this when you know the repository. Use azuredevops_repositories_list to browse.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `project` (`string`, required): Name or ID of the Azure DevOps project. Example: Fabrikam-Fiber
- `repository_id` (`string`, required): Name or ID of the Git repository in the project. Example: fabrikam-web

Example input: `{"project":"<project>","repository_id":"<repository_id>"}`

### `azuredevops_teams_list`

List Teams · Read-only

List the teams in an Azure DevOps project.
Returns each team's id, name and description.
Use this to find a team name, for example for area paths or WIQL @currentIteration queries.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `project` (`string`, required): Name or ID of the Azure DevOps project. Example: Fabrikam-Fiber
- `mine` (`boolean`, optional): Only return teams the user belongs to. Example: true
- `skip` (`integer`, optional): Number of teams to skip, for paging. Example: 50
- `top` (`integer`, optional): Maximum number of teams to return. Example: 100

Example input: `{"project":"<project>"}`

### `azuredevops_work_item_comments_list`

List Work Item Comments · Read-only

List the discussion comments on an Azure DevOps work item.
Returns each comment's id, text, createdBy and createdDate, plus a continuationToken.
Use this to read the discussion. Use azuredevops_work_item_comment_add to post one.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `project` (`string`, required): Name or ID of the Azure DevOps project. Example: Fabrikam-Fiber
- `work_item_id` (`integer`, required): ID of the work item. Example: 42
- `continuation_token` (`string`, optional): Continuation token from the x-ms-continuationtoken header or continuationToken field of the previous page. Example: 5
- `order` (`string`, optional): Sort order by date: asc or desc. Example: desc. One of: `asc`, `desc`.
- `top` (`integer`, optional): Maximum number of comments to return. Example: 50

Example input: `{"project":"<project>","work_item_id":42}`

### `azuredevops_work_item_get`

Get Work Item · Read-only

Get one Azure DevOps work item by ID.
Returns its id, rev, fields and, with expand, its relations (parent, children, links) and _links.
Use this for one item's full details. Use azuredevops_work_items_get for several at once.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `project` (`string`, required): Name or ID of the Azure DevOps project. Example: Fabrikam-Fiber
- `work_item_id` (`integer`, required): ID of the work item. Example: 42
- `expand` (`string`, optional): Extra data to include: none, relations, fields, links or all. Example: relations. One of: `none`, `relations`, `fields`, `links`, `all`.

Example input: `{"project":"<project>","work_item_id":42}`

### `azuredevops_work_item_types_list`

List Work Item Types · Read-only

List the work item types of an Azure DevOps project, such as Bug, Task or User Story.
Returns each type's name, referenceName, description, states and fields.
Use this to find the exact type name and field names before azuredevops_work_item_create.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `project` (`string`, required): Name or ID of the Azure DevOps project. Example: Fabrikam-Fiber

Example input: `{"project":"<project>"}`

### `azuredevops_work_items_get`

Get Work Items · Read-only

Get up to 200 work items by ID in one call.
Returns each work item's id, rev and fields (title, state, assigned to, and so on).
Use this after azuredevops_work_items_query. Use azuredevops_work_item_get for one item with its relations.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `ids` (`string`, required): Comma-separated work item IDs, at most 200. Example: 42,43,57
- `project` (`string`, required): Name or ID of the Azure DevOps project. Example: Fabrikam-Fiber
- `error_policy` (`string`, optional): fail (default) stops on a missing ID; omit returns null for it instead. Example: omit. One of: `fail`, `omit`.
- `fields` (`string`, optional): Comma-separated field reference names to return. Cannot be combined with expand. Example: System.Id,System.Title,System.State,System.AssignedTo

Example input: `{"ids":"<ids>","project":"<project>"}`

### `azuredevops_work_items_query`

Query Work Items (WIQL) · Read-only

Find work items with a WIQL query, such as all active bugs assigned to me.
Returns the matching work item IDs (and URLs) in workItems, not their fields.
Use this to search. Then pass the IDs to azuredevops_work_items_get to read the fields.

Read only: yes. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `project` (`string`, required): Name or ID of the Azure DevOps project. Example: Fabrikam-Fiber
- `query` (`string`, required): WIQL query text. Example: SELECT [System.Id] FROM WorkItems WHERE [System.TeamProject] = @project AND [System.State] = 'Active' AND [System.AssignedTo] = @me ORDER BY [System.ChangedDate] DESC
- `top` (`integer`, optional): Maximum number of work items to return. Example: 200

Example input: `{"project":"<project>","query":"<query>"}`

### `azuredevops_pipeline_run`

Run Pipeline · Write

Start a run of a pipeline, optionally on a specific branch and with template parameters or variables.
Returns the new run with its id and state.
Use this to trigger a build or deployment. Use azuredevops_pipeline_run_get to follow it. Set preview_run to only render the final YAML.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `pipeline_id` (`integer`, required): ID of the pipeline. Get it from azuredevops_pipelines_list. Example: 12
- `project` (`string`, required): Name or ID of the Azure DevOps project. Example: Fabrikam-Fiber
- `branch` (`string`, optional): Branch of the pipeline's own repository to run, as a full ref. Example: refs/heads/main
- `preview_run` (`boolean`, optional): Do not start a run; only return the final YAML. Example: false
- `template_parameters` (`object`, optional): Values for the pipeline's runtime parameters. Example: {"environment": "staging"}
- `variables` (`object`, optional): Values for variables marked settable at queue time, keyed by name. Example: {"logLevel": "debug"}

Example input: `{"pipeline_id":12,"project":"<project>"}`

### `azuredevops_pull_request_create`

Create Pull Request · Write

Open a pull request from one branch into another in a Git repository.
Returns the new pull request with its pullRequestId and URL.
Use this to propose changes. Use azuredevops_pull_request_update to complete, abandon or edit it.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `project` (`string`, required): Name or ID of the Azure DevOps project. Example: Fabrikam-Fiber
- `repository_id` (`string`, required): Name or ID of the Git repository in the project. Example: fabrikam-web
- `source_ref_name` (`string`, required): Branch with the changes, as a full ref. Example: refs/heads/feature/login
- `target_ref_name` (`string`, required): Branch to merge into, as a full ref. Example: refs/heads/main
- `title` (`string`, required): Title of the pull request. Example: Fix Safari login
- `description` (`string`, optional): Description in Markdown. Example: Fixes AB#42
- `is_draft` (`boolean`, optional): Create as a draft pull request. Example: false
- `reviewer_ids` (`array`, optional): User or group IDs to add as reviewers. Example: ["d6245f20-2af8-44f4-9451-8107cb2767db"]
- `work_item_ids` (`array`, optional): Work item IDs to link. Example: ["42"]

Example input: `{"project":"<project>","repository_id":"<repository_id>","source_ref_name":"<source_ref_name>","target_ref_name":"<target_ref_name>","title":"<title>"}`

### `azuredevops_pull_request_thread_create`

Comment on Pull Request · Write

Start a comment thread on a pull request, either general or on a line of a file.
Returns the new thread with its id and first comment.
Use this to leave review feedback. Use azuredevops_pull_request_threads_list to read existing threads.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `content` (`string`, required): Comment text in Markdown. Example: Please add a test for Safari.
- `project` (`string`, required): Name or ID of the Azure DevOps project. Example: Fabrikam-Fiber
- `pull_request_id` (`integer`, required): ID of the pull request. Example: 17
- `repository_id` (`string`, required): Name or ID of the Git repository in the project. Example: fabrikam-web
- `file_path` (`string`, optional): File to comment on, starting with /. Omit for a general comment. Example: /src/login.ts
- `line` (`integer`, optional): Line number in the new version of the file (needs file_path). Example: 27
- `status` (`string`, optional): Thread status: active (default), fixed, wontFix, closed, byDesign or pending. Example: active. One of: `active`, `fixed`, `wontFix`, `closed`, `byDesign`, `pending`. Default: `active`.

Example input: `{"content":"<content>","project":"<project>","pull_request_id":17,"repository_id":"<repository_id>"}`

### `azuredevops_pull_request_update`

Update Pull Request · Write

Update a pull request: edit its title or description, publish a draft, abandon or reactivate it, or complete (merge) it.
Returns the updated pull request.
Use this to change or merge a pull request. To complete it, set status to completed and pass last_merge_source_commit_id from azuredevops_pull_request_get.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `project` (`string`, required): Name or ID of the Azure DevOps project. Example: Fabrikam-Fiber
- `pull_request_id` (`integer`, required): ID of the pull request. Example: 17
- `repository_id` (`string`, required): Name or ID of the Git repository in the project. Example: fabrikam-web
- `delete_source_branch` (`boolean`, optional): Delete the source branch after completing. Example: true
- `description` (`string`, optional): New description in Markdown. Example: Fixes AB#42 and AB#43
- `is_draft` (`boolean`, optional): Set to false to publish a draft pull request. Example: false
- `last_merge_source_commit_id` (`string`, optional): Required when status is completed: the source branch commit the merge is based on, from lastMergeSourceCommit.commitId of azuredevops_pull_request_get. Example: 6c5b0bb3d7f9e7b5f0a3c2c1e1f3b5a8d9e0f1a2
- `merge_strategy` (`string`, optional): How to merge when completing: noFastForward, squash, rebase or rebaseMerge. Example: squash. One of: `noFastForward`, `squash`, `rebase`, `rebaseMerge`.
- `status` (`string`, optional): New status: active (reactivate), abandoned or completed (merge). Example: completed. One of: `active`, `abandoned`, `completed`.
- `title` (`string`, optional): New title. Example: Fix Safari login (v2)

Example input: `{"project":"<project>","pull_request_id":17,"repository_id":"<repository_id>"}`

### `azuredevops_work_item_comment_add`

Add Work Item Comment · Write

Post a discussion comment on an Azure DevOps work item.
Returns the new comment with its id.
Use this to comment. Use azuredevops_work_item_update to change fields.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `project` (`string`, required): Name or ID of the Azure DevOps project. Example: Fabrikam-Fiber
- `text` (`string`, required): Comment text, in Markdown or HTML according to format. Example: Reproduced on Safari 17.1
- `work_item_id` (`integer`, required): ID of the work item. Example: 42
- `format` (`string`, optional): Format of the text: markdown or html. Defaults to markdown. Example: markdown. One of: `markdown`, `html`. Default: `markdown`.

Example input: `{"project":"<project>","text":"<text>","work_item_id":42}`

### `azuredevops_work_item_create`

Create Work Item · Write

Create a work item, such as a bug, task or user story, in an Azure DevOps project.
Returns the new work item with its id and fields.
Use this to file new work. Use azuredevops_work_item_update to change an existing item.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `project` (`string`, required): Name or ID of the Azure DevOps project. Example: Fabrikam-Fiber
- `title` (`string`, required): Title of the work item. Example: Login button does nothing on Safari
- `work_item_type` (`string`, required): Work item type to create, as named in the project's process. Example: Bug
- `fields` (`object`, optional): Work item fields to set, as an object keyed by field reference name. Common fields: System.Title, System.Description (HTML), System.State, System.AssignedTo (user email), System.AreaPath, System.IterationPath, System.Tags (semicolon-separated) and Microsoft.VSTS.Common.Priority (1-4). Example: {"System.Description": "Steps to reproduce...
", "Microsoft.VSTS.Common.Priority": 2, "System.Tags": "web; login"}
- `parent_url` (`string`, optional): URL of a parent work item to link to. Example: https://dev.azure.com/fabrikam/_apis/wit/workItems/40
- `validate_only` (`boolean`, optional): Only check the request without saving the work item. Example: false

Example input: `{"project":"<project>","title":"<title>","work_item_type":"<work_item_type>"}`

### `azuredevops_work_item_update`

Update Work Item · Write

Update fields of an Azure DevOps work item, such as its state, assignee or title, and optionally add a discussion comment.
Returns the updated work item.
Use this to change an item. Use azuredevops_work_item_comment_add to only post a comment.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `project` (`string`, required): Name or ID of the Azure DevOps project. Example: Fabrikam-Fiber
- `work_item_id` (`integer`, required): ID of the work item. Example: 42
- `comment` (`string`, optional): Comment added to the work item's discussion history with this change. Example: Fixed in PR 17
- `fields` (`object`, optional): Work item fields to set, as an object keyed by field reference name. Common fields: System.Title, System.Description (HTML), System.State, System.AssignedTo (user email), System.AreaPath, System.IterationPath, System.Tags (semicolon-separated) and Microsoft.VSTS.Common.Priority (1-4). Example: {"System.State": "Resolved", "System.AssignedTo": "alex@fabrikam.com"}
- `parent_url` (`string`, optional): URL of a parent work item to link to. Example: https://dev.azure.com/fabrikam/_apis/wit/workItems/40
- `title` (`string`, optional): New title. Example: Login button does nothing on Safari 17

Example input: `{"project":"<project>","work_item_id":42}`

### `azuredevops_work_item_delete`

Delete Work Item · Destructive

Delete an Azure DevOps work item by moving it to the recycle bin.
Returns the deleted work item reference.
Use this to remove an item; it can be restored from the recycle bin. Use azuredevops_work_item_update to close it instead.

Read only: no. Destructive: yes. Idempotent (safe to retry): yes.

Inputs:

- `project` (`string`, required): Name or ID of the Azure DevOps project. Example: Fabrikam-Fiber
- `work_item_id` (`integer`, required): ID of the work item. Example: 42

Example input: `{"project":"<project>","work_item_id":42}`

## Related

Other Developer Tools connectors ([all 200](/agentkit/connectors/?category=developer-tools)):

- [GitHub](/agentkit/connectors/github/): Scalekit connector, OAuth, 217 tools
- [Datadog](/agentkit/connectors/datadog/): Scalekit connector, API key, 105 tools
- [Linear](/agentkit/connectors/linear/): Scalekit connector, OAuth, 64 tools


---

## More Scalekit documentation

| Resource | What it contains | When to use it |
|----------|-----------------|----------------|
| [/llms.txt](/llms.txt) | Structured index with routing hints per product area | Start here — find which documentation set covers your topic before loading full content |
| [/llms-full.txt](/llms-full.txt) | Complete documentation for all Scalekit products in one file | Use when you need exhaustive context across multiple products or when the topic spans several areas |
| [sitemap-0.xml](https://docs.scalekit.com/sitemap-0.xml) | Full URL list of every documentation page | Use to discover specific page URLs you can fetch for targeted, page-level answers |
