---
search:
  tags:
    - helpdesk
    - PUT
seo:
  description: >-
    Updates workspace-wide default helpdesk settings. These settings apply to…
    Reference for the PUT /helpdesk/settings endpoint in the Leadtime Public API
    API.
sidebar:
  badge: PUT
  label: Update workspace helpdesk settings
title: Update workspace helpdesk settings
type: openapi-operation
---
Updates workspace-wide default helpdesk settings. These settings apply to all email accounts unless overridden at the account level.

**What can be configured:**
- **Default task priority**: Priority level for all helpdesk tasks (Urgent, High, Normal, Low)
- **Default task type**: Task type ID that will be assigned to helpdesk tasks
- **Default task status**: Task status ID for newly created helpdesk tasks
- **Auto-assign user**: Optional user ID to automatically assign tasks to
- **Default reply body**: HTML template for automatic replies (supports variables like `taskNumber`)
- **Send default reply**: Whether to automatically send replies to new email senders

**How it works:**
- These settings become the base configuration for all helpdesk operations
- Individual email accounts can override any of these defaults
- When an email account has no specific settings, it uses these workspace defaults
- The `isHelpdeskEnabled` flag is preserved from current settings (not updated via this endpoint)

**Auto-reply system:**
When `sendDefaultReply` is enabled, the system automatically sends replies to initial emails from new senders:
- Only triggers for first-time senders (not replies to existing conversations)
- Uses the `defaultReplyBody` template with variable substitution
- Variables like `taskNumber` are replaced with actual values
- Replies are sent from the same email account that received the original email

**Note:** This endpoint requires the `WsSettings.manageSettings` permission. Changes affect all email accounts that don't have account-specific overrides.

<Operation source="api-reference" id="helpdeskcontroller-updatehelpdesksettings" />
