---
title: "Set Service State"
method: PATCH
path: "/system/basic-settings/services/{service}"
tags: ["System"]
---

# Set Service State

`PATCH /system/basic-settings/services/{service}`

Set the desired enabled state of a service in the system settings

## Path parameters

- `service` string, required

## Request body

- InternalHandlersSystemSetServiceStateRequest
  - `enabled` boolean, required

## Response `200`

Success

- GithubComAlchemillahqSylveInternalAPIResponseInternalHandlersSystemServiceStateResponse
  - `data` InternalHandlersSystemServiceStateResponse
    - `changed` boolean
    - `enabled` boolean
    - `service` 'dhcp-server' | 'jails' | 'samba-server' | 'virtualization' | 'wol-server' | 'firewall' | 'wireguard' | 'iscsi' | 'mdns'
  - `error` string
  - `message` string
  - `status` string

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `413` — Request Entity Too Large
- `500` — Internal Server Error

---

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