---
title: "Ban User"
method: PUT
path: "/servers/{server}/bans/{target}"
tags: ["Server Members"]
---

# Ban User

`PUT /servers/{server}/bans/{target}`

Ban a user by their id.

## Path parameters

- `server` string, required
- `target` string, required

## Headers

- `X-Audit-Log-Reason` string

## Request body

- DataBanCreate — Information for new server ban
  - `reason` string, nullable — Ban reason
  - `delete_message_seconds` integer, nullable — Messages to delete in seconds

## Response `200`

- ServerBan — Server Ban
  - `_id` MemberCompositeKey, required — Composite primary key consisting of server and user id
    - `server` string, required — Server Id
    - `user` string, required — User Id
  - `reason` string, nullable — Reason for ban creation

## Other responses

- `default` — An error occurred.

---

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