---
title: "Ban a user or lift a ban. Nothing of theirs is lost either way"
method: PUT
path: "/instances/{instance_id}/auth/users/{user_id}/ban"
tags: ["engines"]
---

# Ban a user or lift a ban. Nothing of theirs is lost either way

`PUT /instances/{instance_id}/auth/users/{user_id}/ban`

## Request

- Base URL: `https://app.lathe.live/api/v1`
- URL: `https://app.lathe.live/api/v1/instances/{instance_id}/auth/users/{user_id}/ban`
- Auth: none declared

## Path parameters

- `instance_id` string, required
- `user_id` string, required

## Request body

- AuthBanIn
  - `banned` boolean, required: true: their sessions are refused and no new one opens. false lifts it.
  - `confirm` string: The exact change string returned by a refused ban request. Lifting a ban needs none.

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/lathe/apis/lathe-customer-api.md) · [All operations](https://skmtc.dev/lathe/apis/lathe-customer-api/llms.txt) · [OpenAPI document](https://skmtc.dev/lathe/apis/lathe-customer-api/revisions/68cfd9bb71c1?raw)