---
title: "Update Samba global configuration"
method: PUT
path: "/samba/config"
tags: ["Samba"]
---

# Update Samba global configuration

`PUT /samba/config`

Update the Samba global configuration settings

## Request body

- InternalHandlersSambaSambaConfigRequest
  - `advertiseMdns` boolean
  - `appleExtensions` boolean
  - `bindInterfacesOnly` boolean
  - `extraGlobalConfig` string
  - `interfaces` string
  - `serverString` string
  - `unixCharset` string
  - `workgroup` string

## Response `200`

Success

- GithubComAlchemillahqSylveInternalAPIResponseAny
  - `data` unknown
  - `error` string
  - `message` string
  - `status` string

## Other responses

- `400` — Bad Request
- `403` — Forbidden
- `413` — Payload Too Large
- `500` — Internal Server Error

## Changes

- **2026-08-29** `b7a0c0d622eb` — 2 info
  - added the non-success response with the status `403`
  - added the non-success response with the status `413`
- **2026-08-12** `9a5026bf9057` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/alchemillahq/apis/sylve-api/changes/samba/config/put.md)

---

[API](https://skmtc.dev/alchemillahq/apis/sylve-api.md) · [All operations](https://skmtc.dev/alchemillahq/apis/sylve-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/alchemillahq/sylve-api/revisions/438105f28a33/schema)