Refine a 2ools project
refine_projectCreate a protected child version from a saved base and review feedback, returning an async job ID for the revision.
Instructions
Create one protected child version from a saved base version and concrete review feedback. Preserves the base source as currentCode, consumes one persisted project iteration, and returns an asynchronous job_id.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"project_id": "<project_id>",
"base_version_id": "<base_version_id>",
"feedback": "<feedback>",
"idempotency_key": "<idempotency_key>"
},
"name": "refine_project"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| model | No | Generation engine for this child revision. Studio safely preserves the parent but cannot apply substantive edits; choose an AI model or linked Engine for real revisions. | studio |
| feedback | Yes | Specific requested changes. Requirements not explicitly changed remain in force. | |
| project_id | Yes | Project containing the saved base version. | |
| base_version_id | Yes | Authoritative saved version to use as the parent and current source. | |
| idempotency_key | Yes | Unique retry key. Reuse returns the original revision job without consuming another iteration. |