---
title: "Update Workspace Settings"
method: PUT
path: "/api/workspaces/{workspace_id}/settings"
---

# Update Workspace Settings

`PUT /api/workspaces/{workspace_id}/settings`

## Path parameters

- `workspace_id` string, required

## Request body

- WorkspaceSettingsUpdateRequest
  - `phoneNumbers` PhoneNumbersSettingsInput
    - `outboundNumbers` string[], nullable
    - `inboundNumber` string, nullable
  - `voiceSettings` VoiceSettingsInput
    - `vadEnabled` boolean, nullable
    - `minimumTurnDuration` integer, nullable
    - `turnEndpointDelay` integer, nullable
    - `minimumInterruptionDuration` integer, nullable
  - `aiSettings` AISettingsInput
    - `temperature` number, nullable
    - `agentTalksFirst` boolean, nullable
    - `uninterruptable` boolean, nullable
    - `callProvider` string, nullable
    - `telephonyProvider` string, nullable
  - `transferSettings` TransferSettingsInput
    - `enableHumanTransfer` boolean, nullable
    - `enableDeviationTool` boolean, nullable
  - `initialMessageSettings` InitialMessageSettingsInput
    - `enableCustomFirstMessage` boolean, nullable
    - `customFirstMessage` string, nullable
  - `notificationSettings` NotificationSettingsInput
    - `sendEodReports` boolean, nullable
    - `eodReportFrequency` string, nullable
  - `followUpEmailSettings` FollowUpEmailSettingsInput
    - `enableFollowUpEmail` boolean, nullable
    - `followUpEmailSendgridApiKey` string, nullable
    - `followUpEmailFromEmail` string, nullable
  - `aiContextSettings` AIContextSettingsInput
    - `includePreviousCallContext` boolean, nullable
  - `scheduleSettings` ScheduleSettingsInput
    - `scheduleEnabled` boolean, nullable
    - `scheduledCallingAgentIds` string[], nullable
    - `callbackTasksEnabled` boolean, nullable
    - `scheduledCallRetryDelayEnabled` boolean, nullable
    - `scheduledCallRetryDelayHours` integer, nullable
    - `scheduledCallMaxRetryAttempts` integer, nullable
    - `startTime` string, nullable
    - `endTime` string, nullable
  - `queueSettings` QueueSettingsInput
    - `batchSize` integer, nullable
    - `batchDelaySeconds` integer, nullable

## Response `200`

Successful Response

- WorkspaceSettingsResponse
  - `type` string, nullable
  - `sidebarPages` string[]
  - `scheduleEnabled` boolean
  - `scheduledCallingAgentIds` string[]
  - `callbackTasksEnabled` boolean
  - `scheduledCallRetryDelayEnabled` boolean
  - `scheduledCallRetryDelayHours` integer
  - `scheduledCallMaxRetryAttempts` integer
  - `startTime` string
  - `endTime` string
  - `temperature` number
  - `agentTalksFirst` boolean
  - `interruptable` boolean
  - `vadEnabled` boolean
  - `minimumTurnDuration` integer
  - `turnEndpointDelay` integer
  - `minimumInterruptionDuration` integer
  - `sendEodReports` boolean
  - `eodReportFrequency` string
  - `enableFollowUpEmail` boolean
  - `followUpEmailFromEmail` string, nullable
  - `enableManagerTransfer` boolean
  - `enableDeviationTool` boolean
  - `enableCustomFirstMessage` boolean
  - `customFirstMessage` string, nullable
  - `callBatchSize` integer
  - `callBatchDelaySeconds` integer
  - `callProvider` string
  - `telephonyProvider` string
  - `includePreviousCallContext` boolean
  - `hasFollowUpEmailApiKey` boolean
  - `outboundNumbers` string[]
  - `inboundNumber` string

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/outcallerai/apis/fastapi.md) · [All operations](https://skmtc.net/outcallerai/apis/fastapi/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/outcallerai/fastapi/revisions/a57f684e7966/schema)