使用VSTS REST API创建Task工作项遇404错误，求参数传递及解决方法

算力阿峰

2026-5-28

解决VSTS REST API创建Task工作项返回404的问题

你遇到的404错误大概率是URL格式或请求头设置不当导致的，我帮你梳理下关键修复点：

1. 正确替换`${type}`参数

API URL里的${type}是占位符，需要直接替换为工作项类型名称Task，不要保留花括号。正确的URL格式应为：

https://{accountName}.visualstudio.com/{project}/_apis/wit/workitems/$Task?api-version=5.0-preview.3

注意$和Task之间直接拼接，不要加任何符号。

2. 必须设置正确的请求头

该API要求请求体为JSON Patch格式，因此必须在请求头中添加：

Content-Type: application/json-patch+json

如果未设置这个头，API无法正确解析请求，很可能返回404或其他错误。

3. 验证项目与账户名称的准确性

确认{accountName}是你的Azure DevOps组织名称（而非个人用户名）
确认{project}是项目的准确名称，若项目名包含空格，需进行URL编码（比如My Project要写成My%20Project）

4. 完整请求示例（curl）

这里给你一个可参考的curl命令示例，替换为你的实际信息即可使用：

curl -X POST \
  https://your-org.visualstudio.com/your-project/_apis/wit/workitems/$Task?api-version=5.0-preview.3 \
  -H 'Authorization: Basic YOUR_BASE64_ENCODED_PAT' \
  -H 'Content-Type: application/json-patch+json' \
  -d '[
  {
    "op": "add",
    "path": "/fields/System.Title",
    "from": null,
    "value": "Sample task"
  }
]'

注：YOUR_BASE64_ENCODED_PAT是将你的个人访问令牌（PAT）前加冒号（如:your-pat-token）后进行Base64编码的结果