All tools
ToolWrite
Patch Project source tags
patch_project_item_tagsYou need matching folders, sources, notes, recent changes, or library metadata.
When to use it
You need matching folders, sources, notes, recent changes, or library metadata.
Typical workflow
Find candidate library objects before reading full evidence.
What it returns
Metadata lists, ids, snippets, activity, and discovery hints.
Avoid using it when
You need exact quoted evidence from a long source; use chunk tools instead.
Advanced input contract
Agent hosts use this JSON Schema to validate the exact input shape.
View JSON Schema
{
"type": "object",
"properties": {
"projectId": {
"type": "string",
"format": "uuid"
},
"items": {
"type": "array",
"minItems": 1,
"maxItems": 50,
"items": {
"type": "object",
"properties": {
"fileId": {
"type": "string",
"format": "uuid"
},
"expectedUpdatedAt": {
"type": "string",
"format": "date-time"
}
},
"required": [
"fileId",
"expectedUpdatedAt"
],
"additionalProperties": false
}
},
"add": {
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 40
},
"maxItems": 12,
"default": []
},
"remove": {
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 40
},
"maxItems": 12,
"default": []
},
"idempotencyKey": {
"type": "string",
"minLength": 1,
"maxLength": 200,
"description": "Required for mode=preview. Reuse only to retry this exact tag patch."
},
"operationId": {
"type": "string",
"format": "uuid",
"description": "Operation id returned by this action's preview."
},
"commitToken": {
"type": "string",
"minLength": 1,
"maxLength": 500,
"description": "Commit token returned by this action's preview."
},
"mode": {
"type": "string",
"enum": [
"preview",
"commit"
],
"default": "preview"
}
},
"required": [
"projectId",
"items"
],
"additionalProperties": false
}