PATCH
/
agent-profiles
/
{profile_id}
JavaScript
import BrowserUse from 'browser-use-sdk';

const client = new BrowserUse({
  apiKey: 'My API Key',
});

const agentProfileView = await client.agentProfiles.update('182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e');

console.log(agentProfileView.id);
{
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "name": "<string>",
  "description": "<string>",
  "highlightElements": true,
  "maxAgentSteps": 123,
  "allowedDomains": [
    "<string>"
  ],
  "flashMode": true,
  "thinking": true,
  "vision": true,
  "customSystemPromptExtension": "<string>",
  "createdAt": "2023-11-07T05:31:56Z",
  "updatedAt": "2023-11-07T05:31:56Z"
}

Authorizations

​
X-Browser-Use-API-Key
string
header
required

Path Parameters

​
profile_id
string<uuid>
required

Body

application/json

Request model for updating an agent profile

Attributes: name: Display name for the profile description: Optional description of the profile highlight_elements: Whether to highlight elements during agent interaction max_agent_steps: Maximum number of steps the agent can take allowed_domains: List of domains the agent is allowed to access flash_mode: Whether flash mode is enabled thinking: Whether thinking mode is enabled vision: Whether vision capabilities are enabled custom_system_prompt_extension: Optional custom system prompt for the agent

Response

200
application/json

Successful Response

View model for representing an agent profile

Attributes: id: Unique identifier for the profile name: Display name for the profile description: Optional description of the profile highlight_elements: Whether to highlight elements during agent interaction with the browser max_agent_steps: Maximum number of steps the agent can take before stopping allowed_domains: List of domains the agent is allowed to access flash_mode: Whether flash mode is enabled thinking: Whether thinking mode is enabled vision: Whether vision capabilities are enabled custom_system_prompt_extension: Optional custom system prompt for the agent created_at: Timestamp when the profile was created updated_at: Timestamp when the profile was last updated