Update Agent autonomy settings
Set the persistent Hermes command-approval mode for one authorized Agent. Workspace owner/admin permission is required.
API 2.7.0 · Published service contract ↗
Request
Base URL: https://app.sym.so/v1/workspaces/{workspace_id}
Authentication: bearer. Required scope: settings:write.
PUT /agents/{agent_id}/settings
Set the persistent Hermes command-approval mode for one authorized Agent. Workspace owner/admin permission is required.
| Parameter | Type | Description |
|---|---|---|
agent_idpath · required | string | Authorized Agent ID. |
approval_modebody · required | manual | smart | off | Persistent command-approval policy. off enables Full access. |
curl --fail-with-body -X PUT "https://app.sym.so/v1/workspaces/$WORKSPACE_ID/agents/$AGENT_ID/settings" \
-H "Authorization: Bearer $SYM_WORKSPACE_API_KEY" \
-H "Content-Type: application/json" \
--data "{\"approval_mode\":\"off\"}"{
"worker_id": "worker-example-001",
"org_id": "workspace_example",
"item": {
"profile_id": "agent_example",
"hermes_profile": "agent_example",
"approval_mode": "off",
"can_manage": true,
"config_present": true,
"changed": true
},
"applies_immediately": true,
"ok": true
}Authorization
{
"type": "bearer",
"scope": "settings:write",
"transport": "Authorization: Bearer <workspace_api_key>"
}Errors
| Status | Description |
|---|---|
| 400 | The request body or parameters are invalid. |
| 401 | The workspace API key is missing, invalid, expired, or revoked. |
| 403 | The key lacks the required scope or its owner no longer has permission. |
| 404 | The resource is missing or intentionally hidden by authorization. |
| 429 | The key exceeded its current rate limit. |
Usage notes
- Only the approvals.mode field is changed; unrelated Hermes configuration is preserved atomically.
- This operation does not reset or restart any chat, session, Gateway, tmux process, or Agent runtime.
- Full access bypasses ordinary risky-command prompts but does not bypass operating-system permissions, explicit deny rules, workspace/profile authorization, or unrecoverable system-safety blocks.