---
title: "Update agent setting"
method: PUT
path: "/public/v1/agents/{agentId}/agent-setting"
tags: ["Agent Builder"]
---

# Update agent setting

`PUT /public/v1/agents/{agentId}/agent-setting`

Updates instructions, model, tools, playbooks, connected accounts, and system tool settings. Requires a USER API key.

## Path parameters

- `agentId` string, required

## Request body

- PublicAgentSettingUpdateInput
  - `aiModelId` number, nullable, required
  - `temperature` number, required
  - `instructions` string, nullable, required
  - `maxIterations` number
  - `agentType` 'BASIC' | 'ADVANCED'
  - `customToolIds` number[], nullable
  - `connectedAccountConfigs` object[], nullable
    - `connectedAccountId` number, required
    - `useAllTools` boolean
    - `selectedToolSlugs` string[], nullable
  - `systemToolsConfig` object, nullable
    - `webSearchEnabled` boolean
    - `urlScrapeEnabled` boolean
    - `linkedinSearchEnabled` boolean
  - `selectedRecordTypes` object[], nullable
    - `recordTypeId` number, required
    - `read` boolean
    - `create` boolean
    - `update` boolean
    - `delete` boolean
    - `createActivity` boolean

## Response `200`

Updated agent setting

- AgentSetting, nullable
  - `id` number, required
  - `aiModelId` number, nullable
  - `aiModel` AiModel
    - `id` number, required
    - `name` string, required
    - `description` string, nullable
    - `creditsPerMessage` number
    - `isDefault` boolean
    - `order` number
    - `analyticsColor` string, nullable
    - `externalId` string, nullable
    - `aiVendor` string
    - `reasoningModel` boolean
    - `type` 'TEXT' | 'TRANSCRIPTION' | 'FILE_ANALYSIS'
  - `model` string, nullable
  - `aiType` 'ASSISTANT' | 'AGENT'
  - `temperature` number
  - `instructions` string, nullable
  - `agentRole` 'NONE' | 'CUSTOM' | 'CUSTOMER_SUPPORT' | 'SALES_REPRESENTATIVE' | 'COLLECTIONS' | 'RECRUITING_AGENT' | 'HR_MANAGER' | 'PRODUCT_COPILOT' | 'AI_ASSISTANT' | 'ANALYST' | 'POST_SALES'
  - `toneOfVoice` 'NONE' | 'CUSTOM' | 'FRIENDLY' | 'NEUTRAL' | 'MATTER_OF_FACT' | 'PROFESSIONAL' | 'HUMOROUS' | 'WITTY' | 'GEN_Z'
  - `answerLength` 'NONE' | 'CUSTOM' | 'DYNAMIC' | 'CONCISE' | 'STANDARD' | 'THOROUGH'
  - `maxIterations` number
  - `agentType` 'BASIC' | 'ADVANCED'
  - `customTools` object[], nullable
    - `id` number, required
    - `name` string, required
    - `description` string, nullable
    - `status` string, nullable
    - `type` string, nullable
  - `systemToolsConfig` object, nullable
  - `selectedRecordTypes` object[], nullable
    - `recordTypeId` number, required
    - `read` boolean
    - `create` boolean
    - `update` boolean
    - `delete` boolean
    - `createActivity` boolean
  - `agentConnectedAccounts` object[], nullable
    - `connectedAccountId` number, required
    - `useAllTools` boolean, required
    - `selectedToolSlugs` string[], nullable
    - `connectedAccount` object
      - `id` number, required
      - `toolkit` string, required
      - `alias` string, nullable, required
      - `connectedEmail` string, nullable, required
      - `isConnected` boolean, required
  - `agentPlaybooks` object[], nullable
    - `playbookId` number, required
    - `assignedAt` string
    - `playbook` object
      - `id` number, required
      - `name` string, required
      - `description` string, nullable

---

[API](https://skmtc.net/getfrontline/apis/public-api.md) · [All operations](https://skmtc.net/getfrontline/apis/public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/getfrontline/public-api/versions/9d33b6aad674/schema)