Agent Terminals
Update workspace browser preferences without changing execution permissions
Update workspace browser preferences without changing execution permissions. The request requires an authenticated caller and enforces terminal ownership, access grants, and activity visibility.
POST
/
api
/
v1
/
agents
/
terminals
/
{agentTerminalId}
/
workspaces
/
{workspaceId}
/
browser-settings
Update workspace browser preferences without changing execution permissions
curl --request POST \
--url https://api.revoengine.com/api/v1/agents/terminals/{agentTerminalId}/workspaces/{workspaceId}/browser-settings \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"expectedRevision": 1073741823,
"settings": {
"fps": 32.5,
"width": 2080,
"height": 1320,
"alwaysRecord": true,
"defaultBrowserProfileId": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}
}
'const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
expectedRevision: 1073741823,
settings: {
fps: 32.5,
width: 2080,
height: 1320,
alwaysRecord: true,
defaultBrowserProfileId: '3c90c3cc-0d44-4b50-8888-8dd25736052a'
}
})
};
fetch('https://api.revoengine.com/api/v1/agents/terminals/{agentTerminalId}/workspaces/{workspaceId}/browser-settings', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.revoengine.com/api/v1/agents/terminals/{agentTerminalId}/workspaces/{workspaceId}/browser-settings"
payload = {
"expectedRevision": 1073741823,
"settings": {
"fps": 32.5,
"width": 2080,
"height": 1320,
"alwaysRecord": True,
"defaultBrowserProfileId": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text){
"agentTerminalId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"ownerUserId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"name": "<string>",
"workspace": "<string>",
"workspaces": [
{
"agentTerminalWorkspaceId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"name": "<string>",
"path": "<string>",
"status": "pending",
"mode": "review",
"networkMode": "restricted",
"restricted": true,
"users": [
"3c90c3cc-0d44-4b50-8888-8dd25736052a"
],
"groups": [
"3c90c3cc-0d44-4b50-8888-8dd25736052a"
],
"browserSettingsRevision": 1,
"browserSettings": {
"fps": 32.5,
"width": 2080,
"height": 1320,
"alwaysRecord": true,
"recordingMode": "local",
"defaultBrowserProfileId": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
},
"inheritDevicePermissions": true
}
],
"status": "pending",
"mode": "review",
"networkMode": "restricted",
"revision": 123,
"connectionRevision": 123,
"createdAt": "2023-11-07T05:31:56Z",
"updatedAt": "2023-11-07T05:31:56Z",
"restricted": true,
"users": [
"<string>"
],
"groups": [
"<string>"
],
"refToken": "<string>",
"lastOnlineAt": "2023-11-07T05:31:56Z",
"online": true,
"connectionIp": "<string>",
"canManage": true,
"createdBy": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"lastUpdateAt": "2023-11-07T05:31:56Z",
"lastUpdateBy": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"version": 123
}Authorizations
Bearer JWT token or API Key (sk-*).
Body
application/json
Response
201 - application/json
Atomic workspace permission contract under the terminal revision.
Show child attributes
Show child attributes
Available options:
pending, approved Available options:
review, full Available options:
restricted, sandbox, external Runner and conversation connection epoch; command review mode edits keep it unchanged.
Clickable terminal resource reference.
Gateway-observed IP of the active runner, visible only to its owner.
⌘I
Update workspace browser preferences without changing execution permissions
curl --request POST \
--url https://api.revoengine.com/api/v1/agents/terminals/{agentTerminalId}/workspaces/{workspaceId}/browser-settings \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"expectedRevision": 1073741823,
"settings": {
"fps": 32.5,
"width": 2080,
"height": 1320,
"alwaysRecord": true,
"defaultBrowserProfileId": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}
}
'const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
expectedRevision: 1073741823,
settings: {
fps: 32.5,
width: 2080,
height: 1320,
alwaysRecord: true,
defaultBrowserProfileId: '3c90c3cc-0d44-4b50-8888-8dd25736052a'
}
})
};
fetch('https://api.revoengine.com/api/v1/agents/terminals/{agentTerminalId}/workspaces/{workspaceId}/browser-settings', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.revoengine.com/api/v1/agents/terminals/{agentTerminalId}/workspaces/{workspaceId}/browser-settings"
payload = {
"expectedRevision": 1073741823,
"settings": {
"fps": 32.5,
"width": 2080,
"height": 1320,
"alwaysRecord": True,
"defaultBrowserProfileId": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text){
"agentTerminalId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"ownerUserId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"name": "<string>",
"workspace": "<string>",
"workspaces": [
{
"agentTerminalWorkspaceId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"name": "<string>",
"path": "<string>",
"status": "pending",
"mode": "review",
"networkMode": "restricted",
"restricted": true,
"users": [
"3c90c3cc-0d44-4b50-8888-8dd25736052a"
],
"groups": [
"3c90c3cc-0d44-4b50-8888-8dd25736052a"
],
"browserSettingsRevision": 1,
"browserSettings": {
"fps": 32.5,
"width": 2080,
"height": 1320,
"alwaysRecord": true,
"recordingMode": "local",
"defaultBrowserProfileId": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
},
"inheritDevicePermissions": true
}
],
"status": "pending",
"mode": "review",
"networkMode": "restricted",
"revision": 123,
"connectionRevision": 123,
"createdAt": "2023-11-07T05:31:56Z",
"updatedAt": "2023-11-07T05:31:56Z",
"restricted": true,
"users": [
"<string>"
],
"groups": [
"<string>"
],
"refToken": "<string>",
"lastOnlineAt": "2023-11-07T05:31:56Z",
"online": true,
"connectionIp": "<string>",
"canManage": true,
"createdBy": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"lastUpdateAt": "2023-11-07T05:31:56Z",
"lastUpdateBy": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"version": 123
}
