All tools
ToolWrite
Set Project preference
set_project_preferenceYou 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": {
"projectId": {
"type": "string",
"format": "uuid"
},
"isFavorite": {
"type": "boolean"
},
"expectedPreferenceUpdatedAt": {
"type": "string",
"format": "date-time",
"description": "The actor.preferences.updatedAt returned by get_project_access."
},
"idempotencyKey": {
"type": "string",
"minLength": 1,
"maxLength": 200
},
"operationId": {
"type": "string",
"format": "uuid"
},
"commitToken": {
"type": "string",
"minLength": 1
},
"mode": {
"type": "string",
"enum": [
"preview",
"commit"
],
"default": "preview"
}
},
"required": [
"projectId",
"isFavorite",
"expectedPreferenceUpdatedAt"
],
"additionalProperties": false
}