Title99/100
Add a PIN to a folder
The title clearly communicates the tool’s action and subject. Keep it concise.
Description89/100
Give a folder a new 6 digit PIN that visitors must enter, returned in pin; it replaces the folder's old PIN. Fails when the owner's account PIN already guards every folder.
Describe the returned information so the agent knows whether it will answer the request.
Inputs50/100
Clarify units, where to obtain this value, or conventions not already expressed in the schema.
folderId
folder id, such as 1a2b3c4d
Clarify units, where to obtain this value, or conventions not already expressed in the schema.
Annotations100/100
All four behavior hints are declared.
{
"title": "Add a PIN to a folder",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": true
}Output schema43/100
Describe the returned fields so an agent can interpret the result.
View output schema
{
"type": "object",
"required": [
"folderId",
"url",
"expiresAt",
"pinMode",
"pin"
],
"properties": {
"pin": {
"type": "string"
},
"url": {
"type": "string"
},
"pinMode": {
"type": "string"
},
"folderId": {
"type": "string"
},
"expiresAt": {
"type": "string"
}
},
"additionalProperties": false
}