---
title: "Edit Agent Details"
method: PUT
path: "/ca_apis/updateAgent"
tags: ["default"]
---

# Edit Agent Details

`PUT /ca_apis/updateAgent`

Updates the details of an existing agent, such as name, skills, groups, and other attributes.

## Query parameters

- `detailedResponse` boolean

## Headers

- `Content-Type` string, required

## Request body

- object
  - `userName` string, required — The username of the account.
  - `agentId` string, required — The current agent ID.
  - `agentIdNew` string — The updated agent ID.
  - `agentName` string — The current name of the agent.
  - `agentNameNew` string — The updated name of the agent.
  - `email` string — The updated email of the agent.
  - `password` string — The updated password for the agent.
  - `autoAnswer` string — The auto-answer mode for the agent.
  - `inbound` boolean — Enable inbound calls
  - `manual` boolean — Enable manual dialing
  - `preview` boolean — Enable preview dialing
  - `progressive` boolean — Enable progressive dialing
  - `chat` boolean — Enable chat channel
  - `blended` boolean — Enable blended mode
  - `blendedInbound` boolean — Enable inbound calls in blended mode
  - `blendedManual` boolean — Enable manual dialing in blended mode
  - `blendedPreview` boolean — Enable preview mode in blended setup
  - `blendedProgressive` boolean — Enable progressive dialing in blended setup
  - `blendedChat` boolean — Enable chat in blended mode
  - `callControls` object
    - `hold` boolean
    - `mute` boolean
    - `endcall` boolean
    - `answer` boolean
    - `decline` boolean
    - `callrecording` boolean
    - `manualdial` boolean
    - `transfer_agent_warm` boolean
    - `transfer_agent_blind` boolean
    - `transfer_skill_warm` boolean
    - `transfer_skill_blind` boolean
    - `transfer_phone_warm` boolean
    - `transfer_phone_blind` boolean
    - `transfer_ivr_warm` boolean
    - `transfer_ivr_blind` boolean
    - `conference_agent` boolean
    - `conference_phone` boolean
  - `agentData` string — Additional agent metadata
  - `sipLocation` string — SIP registration location for the agent
  - `screenRecording` boolean — Enable screen recording for the agent
  - `assignSkills` object[]
    - `priority` integer
    - `skillName` string
  - `unAssignSkills` object[]
    - `priority` integer
    - `skillName` string
  - `assignAgentGroups` string — Comma-separated list of agent groups to assign
  - `unAssignAgentGroups` string — Comma-separated list of agent groups to unassign
  - `locked` boolean — Lock the agent (true/false)

## Response `200`

Successful response.

---

[API](https://skmtc.net/ozonetel/apis/agent-authentication.md) · [All operations](https://skmtc.net/ozonetel/apis/agent-authentication/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ozonetel/agent-authentication/versions/9096baa9c71b/schema)