---
title: "Restart the Cribl server"
method: POST
path: "/system/settings/restart"
tags: ["system"]
---

# Restart the Cribl server

`POST /system/settings/restart`

Restart the Cribl server.<br/><br/>This operation requires <code>system.restart</code> to be set to <code>api</code> in <code>cribl.yml</code>. If this setting is not configured, the request returns a <code>403</code> error.<br/><br/>Restarting the server causes a brief period of downtime while the process stops and restarts. All in-flight events are drained before the process exits. Use <code>POST /system/settings/reload</code> to apply configuration changes without a full restart.

## Response `200`

Result of the restart operation.

- CountedSystemRestartResponse
  - `count` integer, required — number of items present in the items array
  - `items` SystemRestartResponse[], required — List of items in this response.
    - `restart` true, required — Restart operation initiated.

## Other responses

- `401` — Authentication failed (missing or invalid credentials or Bearer token).
- `403` — Restart from the API is disabled. Set <code>system.restart</code> to <code>api</code> in <code>cribl.yml</code> to enable it.
- `500` — Unexpected server error.

---

[API](https://skmtc.dev/criblio/apis/cribl-api-reference.md) · [All operations](https://skmtc.dev/criblio/apis/cribl-api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/criblio/cribl-api-reference/revisions/56cb25079271/schema)