调用任意 TAPD OpenAPI 接口
tapd_call_apiExecute arbitrary REST calls to TAPD OpenAPI for tasks, stories, modules, wiki, timesheets, and other resources not covered by dedicated tools.
Instructions
通用透传工具：直接调用 TAPD OpenAPI（https://api.tapd.cn）的任意 REST 接口，用于专用工具未覆盖的场景（任务、工时、测试计划、模块/版本配置、Wiki、看板等）。path 为官方文档（open.tapd.cn）中每个接口标注的 URL 路径，例如 GET /tasks（获取任务）、GET /stories/count（需求数量）、GET /modules（模块配置）、POST /timesheets（新增工时）。路径没有统一推导规则，不确定时应以官方文档为准，不要凭猜测拼路径——按 REST 直觉猜容易踩空，例如 Wiki 列表是 /wikis 而非 /wiki，/boards、/reports 也都不是有效路径。几乎所有接口都需要 workspace_id 参数。查询类接口默认返回 30 条，可用 page/limit 翻页。文件上传（multipart）不走本工具，请使用 tapd_upload_bug_attachment / tapd_upload_bug_image。注意：POST 写操作默认禁用，需在 MCP 配置 env 中设置 TAPD_ALLOW_RAW_WRITE=true，且每次调用需传 confirmed=true；优先使用专用写入工具（tapd_create_bug / tapd_writeback 等）。
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| data | No | POST 请求体参数，仅 method=POST 时使用；默认按表单序列化，值为数组/对象时需配合 body_format: "json" | |
| path | Yes | TAPD 接口路径（api.tapd.cn 之后的部分），如 /tasks、/stories/count、/timesheets/delete_timesheets | |
| method | No | HTTP 方法，默认 GET；TAPD 查询用 GET，新增/修改/删除用 POST | |
| params | No | GET 查询参数，如 { workspace_id: "123", limit: 10 } | |
| confirmed | No | method=POST 时必须为 true，表示用户已明确确认本次写操作；GET 无需传 | |
| body_format | No | POST 请求体格式，默认 form（application/x-www-form-urlencoded）；接口文档要求 JSON 请求体（如 batch_update_story 的 workitems 数组）时传 json |