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.
Authorization
bearerAuth In: header
Path Parameters
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response 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, "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, "launchApp": "always", "submitLikeKeys": true }, "appAllowlist": [ "string" ], "redactApps": [], "exposeDriverTools": false, "quietHours": { "tz": "string", "ranges": [ "string" ] }, "leaseIdleSeconds": 120, "leaseMaxSeconds": 1800, "leaseWaitSeconds": 45, "screenshotRetentionDays": 0, "viewerPeerToPeer": 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", "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" } ]}