paperclip_update_agent_permissions
Update an agent's permissions to assign tasks and create new agents. Requires both fields and board-level authentication.
Instructions
⚠ Board-only: Update an agent's governance permissions (canAssignTasks, canCreateAgents). Both fields required.
Args:
agentId: string — Agent UUID (example: "agt_abc123")
canAssignTasks: boolean — Allow this agent to assign tasks to other agents
canCreateAgents: boolean — Allow this agent to create new agents (reserved for CEO by governance policy)
Returns: Returns the updated permissions object: agentId, canAssignTasks, canCreateAgents.
Examples:
Use when: granting or revoking an agent's ability to assign tasks after a board decision
Don't use when: you need to update config fields — use paperclip_update_agent instead
Error Handling:
400: both canAssignTasks and canCreateAgents are required → supply both even if one is unchanged
401: authentication failed → check PAPERCLIP_API_KEY
403: permission denied → this tool requires a board (human) API key
404: agent not found → verify ID with paperclip_list_agents
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| agentId | Yes | Agent UUID | |
| canAssignTasks | Yes | Allow this agent to assign tasks to other agents | |
| canCreateAgents | Yes | Allow this agent to create new agents (reserved for CEO by governance policy) |