All tools
ToolWrite
Move Project folder
move_project_folderYou need the user's accessible workspace map or a compact context pack.
When to use it
You need the user's accessible workspace map or a compact context pack.
Typical workflow
Orient first, then choose the smallest task-specific tool.
What it returns
Workspace availability, recent objects, tool routing, or query-focused context.
Avoid using it when
You already have the exact source, draft, post, artifact, or portfolio id.
Advanced input contract
Agent hosts use this JSON Schema to validate the exact input shape.
View JSON Schema
{
"type": "object",
"properties": {
"folderId": {
"type": "string",
"format": "uuid"
},
"destinationFolderId": {
"type": "string",
"format": "uuid"
},
"expectedSourceUpdatedAt": {
"type": "string",
"format": "date-time"
},
"expectedDestinationUpdatedAt": {
"type": "string",
"format": "date-time"
},
"expectedSubtree": {
"type": "array",
"minItems": 1,
"description": "Exact source-subtree revision snapshot returned by this tool's preview commitBinding.",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string",
"format": "uuid"
},
"updatedAt": {
"type": "string",
"format": "date-time"
}
},
"required": [
"id",
"updatedAt"
],
"additionalProperties": false
}
},
"idempotencyKey": {
"type": "string",
"minLength": 1,
"maxLength": 200,
"description": "Required for mode=preview. Reuse only to retry this exact folder-move request."
},
"operationId": {
"type": "string",
"format": "uuid",
"description": "Operation id returned by this action's preview."
},
"commitToken": {
"type": "string",
"minLength": 1,
"description": "Commit token returned by this action's preview."
},
"mode": {
"type": "string",
"enum": [
"preview",
"commit"
],
"default": "preview"
}
},
"required": [
"folderId",
"destinationFolderId",
"expectedSourceUpdatedAt",
"expectedDestinationUpdatedAt"
],
"additionalProperties": false
}