Set computer agent access
Sets which agents may use a Computer: none (the default), selected with the listed agents, or all for every agent of the organization. This is the one relation an agent’s computer use derives from, so an agent granted here gets the computer_* tools in its next new session without any agent-side setting. Requires edit rights on the Computer, and on a self-hosted desktop only its registrant, since it can widen access to All agents; agents newly listed must be visible to the caller, and a Selected list keeps the existing agents the caller cannot see. An empty selection reads as none, and a selection past 200 agents is refused (409). A per-agent or ephemeral managed computer is used only by its own agent (409). Every change is audited.
授权
bearerAuth 位置: header
路径参数
请求主体
application/json
TypeScript 定义
在 TypeScript 中使用 request body 类型。
响应主体
application/json
application/json
application/json
application/json
application/json
curl -X PUT "https://example.com/v1/orgs/string/computers/string/agent-access" \ -H "Content-Type: application/json" \ -d '{ "mode": "none" }'{ "id": "string", "name": "string", "ownerUserId": "string", "kind": "self-hosted", "isolation": "none", "os": "macos", "osVersion": "string", "session": "aqua", "status": "online", "capabilities": { "screenshot": false, "input": false, "textInput": "full", "humanActivity": "pointer", "backgroundInput": false, "accessibilityTree": false, "viewer": false, "viewerStun": true, "egress": true, "exec": true, "files": true, "formFill": true, "displays": [], "permissions": {} }, "doctor": { "checkedAt": "2019-08-24T14:15:22Z", "checks": [ { "name": "string", "status": "ok", "detail": "string", "fix": "string" } ] }, "desktopDaemonVersion": "string", "driverVersion": "string", "policy": { "allowedMembers": [], "agentMode": "view", "approvals": { "firstInputPerSession": true }, "appAllowlist": [ "string" ], "redactApps": [], "exposeDriverTools": false, "quietHours": { "tz": "string", "ranges": [ "string" ] }, "leaseIdleSeconds": 120, "leaseMaxSeconds": 1800, "leaseWaitSeconds": 45, "screenshotRetentionDays": 0, "viewerPeerToPeer": true, "shell": "off", "files": "off", "fileRoots": [ "string" ], "shareBrowserLogins": true }, "visibility": "org", "sharedWith": [ "string" ], "lastSeenAt": "string", "revokedAt": "string", "stoppedAt": "string", "stoppedByUserId": "string", "createdAt": "string", "updatedAt": "string", "canEdit": true, "screenshotRetentionDays": -9007199254740991, "canEditPolicy": true, "agentAccess": { "mode": "none", "agents": [] }, "canEditAgentAccess": true, "allocation": "ephemeral", "ownerAgentId": "string", "poolSessionId": "string", "poolPhase": "provisioning", "poolError": "string", "poolActions": { "wake": true, "sleep": true, "reset": true }, "lease": { "sessionId": "string", "agentId": "string", "agentName": "string", "acquiredAt": "string" }, "waiting": [ { "sessionId": "string", "agentId": "string", "since": "string" } ], "desktops": [ { "id": "string", "agentId": "string", "status": "online", "lease": { "sessionId": "string", "agentId": "string", "agentName": "string", "acquiredAt": "string" }, "waiting": [ { "sessionId": "string", "agentId": "string", "since": "string" } ] } ]}