---
title: "Patch Workspace Agent"
method: PATCH
path: "/api/workspaces/{workspace_id}/agents/{agent_id}"
---

# Patch Workspace Agent

`PATCH /api/workspaces/{workspace_id}/agents/{agent_id}`

## Request

- Base URL: `https://api.outcallerai.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.outcallerai.com/api/workspaces/{workspace_id}/agents/{agent_id}`
- Auth: none declared

## Path parameters

- `workspace_id` string, required
- `agent_id` string, required

## Request body

- AgentPatchRequest: Partial agent update limited to voice and behaviour settings; role, language and use case assignment are rejected so they can only change through the full update.
  - `name` string, nullable
  - `gender` 'MALE' | 'FEMALE', nullable
  - `voiceId` string[], nullable
  - `voiceUrl` string, nullable
  - `temperature` number, nullable
  - `agentTalksFirst` boolean, nullable
  - `interruptable` boolean, nullable
  - `vadEnabled` boolean, nullable
  - `minimumTurnDuration` integer, nullable
  - `turnEndpointDelay` integer, nullable
  - `minimumInterruptionDuration` integer, nullable

## Response `200`

Successful Response

- OutcallerApiTypesWorkspaceManagementAgentResponse
  - `id` string, required
  - `name` string, required
  - `gender` string, required
  - `role` string, nullable
  - `useCaseId` string, nullable
  - `voiceId` string[]
  - `voiceUrl` string, nullable
  - `primaryLanguage` string, nullable
  - `temperature` number
  - `agentTalksFirst` boolean
  - `interruptable` boolean
  - `vadEnabled` boolean
  - `minimumTurnDuration` integer
  - `turnEndpointDelay` integer
  - `minimumInterruptionDuration` integer
  - `createdAt` string, date-time, required
  - `updatedAt` string, date-time, required

## Other responses

- `422`: Validation Error

## Changes

- **2026-10-01** `7f0fe9282a3c`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/outcallerai/apis/fastapi/changes/api/workspaces/:workspace_id/agents/:agent_id/patch.md)

---

[API](https://skmtc.dev/outcallerai/apis/fastapi.md) - [All operations](https://skmtc.dev/outcallerai/apis/fastapi/llms.txt) - [OpenAPI document](https://skmtc.dev/outcallerai/apis/fastapi/revisions/40736cf433b4?raw)