Settings API

Manage agent settings and configuration.

Endpoints

Method	Endpoint	Description
GET	/api/agents/{id}/settings	Get settings
PUT	/api/agents/{id}/settings	Update settings

Get Settings

GET /api/agents/{id}/settings

Response

{
  "llm_provider": "workers-ai",
  "llm_model": "@cf/meta/llama-3.1-8b-instruct",
  "llm_temperature": 0.7,
  "llm_max_tokens": 2048,
  "llm_system_prompt": "You are a helpful assistant.",

  "calendar_timezone": "UTC",
  "calendar_working_hours_start": "09:00",
  "calendar_working_hours_end": "17:00",
  "calendar_default_duration": 30,

  "workflow_max_concurrent": 5,
  "workflow_default_timeout": 300,
  "workflow_retry_attempts": 3,
  "workflow_retry_delay": 60,

  "browser_headless": true,
  "browser_viewport_width": 1280,
  "browser_viewport_height": 720,
  "browser_user_agent": null,
  "browser_default_timeout": 30000
}

Update Settings

PUT /api/agents/{id}/settings
Content-Type: application/json

Request Body

{
  "llm_provider": "openai",
  "llm_model": "gpt-4-turbo-preview",
  "llm_temperature": 0.5
}

Settings Categories

LLM Settings

Setting	Type	Description
llm_provider	string	AI provider
llm_model	string	Model name
llm_temperature	number	Creativity (0-1)
llm_max_tokens	number	Max response length
llm_system_prompt	string	System instructions

Calendar Settings

Setting	Type	Description
calendar_timezone	string	Timezone
calendar_working_hours_start	string	Start time
calendar_working_hours_end	string	End time
calendar_default_duration	number	Minutes

Workflow Settings

Setting	Type	Description
workflow_max_concurrent	number	Max parallel
workflow_default_timeout	number	Seconds
workflow_retry_attempts	number	Retry count
workflow_retry_delay	number	Seconds

Browser Settings

Setting	Type	Description
browser_headless	boolean	Headless mode
browser_viewport_width	number	Width pixels
browser_viewport_height	number	Height pixels
browser_user_agent	string	Custom UA
browser_default_timeout	number	Milliseconds