---
title: "Update Agent in Account"
method: PATCH
path: "/v1/workspaces/{workspace_id}/agents/{id}"
tags: ["Agents"]
---

# Update Agent in Account

`PATCH /v1/workspaces/{workspace_id}/agents/{id}`

## Request

- Base URL: `https://api.oxvo.com`
- URL: `https://api.oxvo.com/v1/workspaces/{workspace_id}/agents/{id}`
- Auth: API key in header `api_access_token`

Update an Agent in Account

## Path parameters

- `id` integer, required

## Request body

- AgentUpdatePayload
  - `role` 'agent' | 'administrator', required: Whether its administrator or agent
  - `availability_status` 'available' | 'busy' | 'offline': The availability status of the agent.
  - `auto_offline` boolean: Whether the availability status of agent is configured to go offline automatically when away.

## Response `200`

Success

- Agent
  - `id` integer
  - `account_id` integer
  - `availability_status` 'available' | 'busy' | 'offline': The availability status of the agent computed by OXVO.
  - `auto_offline` boolean: Whether the availability status of agent is configured to go offline automatically when away.
  - `confirmed` boolean: Whether the agent has confirmed their email address.
  - `email` string: The email of the agent
  - `available_name` string: The available name of the agent
  - `name` string: The name of the agent
  - `role` 'agent' | 'administrator': The role of the agent
  - `thumbnail` string: The thumbnail of the agent
  - `custom_role_id` integer, nullable: The custom role id of the agent

## Other responses

- `403`: Access denied
- `404`: Agent not found

---

[API](https://skmtc.dev/oxvo/apis/oxvo-apis.md) · [All operations](https://skmtc.dev/oxvo/apis/oxvo-apis/llms.txt) · [OpenAPI document](https://skmtc.dev/oxvo/apis/oxvo-apis/revisions/9a8448cbd1fe?raw)