---
title: "Replace settings"
method: PUT
path: "/3rdparty/v1/settings"
tags: ["User", "Settings"]
---

# Replace settings

`PUT /3rdparty/v1/settings`

Replaces settings

## Request body

- SmsgatewayDeviceSettings
  - `encryption` SmsgatewaySettingsEncryption
    - `passphrase` string — Passphrase is the encryption passphrase. If nil or empty, encryption is disabled. Must not be used with Cloud Server.
  - `gateway` SmsgatewaySettingsGateway
    - `cloud_url` string — CloudURL is the URL of the cloud server. Must not be used with Cloud Server.
    - `notification_channel` 'AUTO' | 'SSE_ONLY' — NotificationChannel is the way device receives notifications.
    - `private_token` string — PrivateToken is the auth token for the private server. Must not be used with Cloud Server.
  - `logs` SmsgatewaySettingsLogs
    - `lifetime_days` integer — LifetimeDays is the number of days to retain logs. Must be at least 1 when provided.
  - `messages` SmsgatewaySettingsMessages
    - `limit_period` 'Disabled' | 'PerMinute' | 'Per30Minutes' | 'PerHour' | 'PerDay'
    - `limit_value` integer — LimitValue is the maximum number of messages allowed per limit period. Must be at least 1 when provided.
    - `log_lifetime_days` integer — LogLifetimeDays is the number of days to retain message logs. Must be at least 1 when provided.
    - `processing_order` 'LIFO' | 'FIFO'
    - `send_interval_max` integer — SendIntervalMax is the maximum interval between message sends (in seconds). Must be at least 1 when provided and greater than or equal to SendIntervalMin.
    - `send_interval_min` integer — SendIntervalMin is the minimum interval between message sends (in seconds). Must be at least 1 when provided.
    - `sim_selection_mode` 'OSDefault' | 'RoundRobin' | 'Random'
    - `work_hours_enabled` boolean — WorkHoursEnabled enables restricting message delivery to a configurable time window.
    - `work_hours_end` string — WorkHoursEnd is the end of the working hours window in HH:mm format (24-hour).
    - `work_hours_start` string — WorkHoursStart is the start of the working hours window in HH:mm format (24-hour).
  - `ping` SmsgatewaySettingsPing
    - `interval_seconds` integer — IntervalSeconds is the interval between ping requests (in seconds). Must be at least 1 when provided.
  - `receiver` SmsgatewaySettingsReceiver
    - `content_provider_enabled` boolean — ContentProviderEnabled enables monitoring the SMS content provider as a fallback for carriers that intercept the SMS_RECEIVED broadcast.
  - `webhooks` SmsgatewaySettingsWebhooks
    - `internet_required` boolean — InternetRequired indicates whether internet access is required for webhooks.
    - `retry_count` integer — RetryCount is the number of times to retry failed webhook deliveries. Must be at least 1 when provided.
    - `signing_key` string — SigningKey is the secret key used for signing webhook payloads. Must not be used with Cloud Server.

## Response `200`

Settings updated

- object

## Other responses

- `400` — Invalid request
- `401` — Unauthorized
- `403` — Forbidden
- `500` — Internal server error

---

[API](https://skmtc.dev/sms-gate/apis/smsgate-api.md) · [All operations](https://skmtc.dev/sms-gate/apis/smsgate-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/sms-gate/smsgate-api/revisions/56a6604029f1/schema)