---
title: "Add limited role for a User"
method: PUT
path: "/api/users/{id}/limited"
tags: ["users"]
---

# Add limited role for a User

`PUT /api/users/{id}/limited`

This endpoint allows the client to limit a user.

The user associated with the API key must have any 'admin' or 'moderator' role.

This specified user will be assigned the 'limited' role. Limiting a user will limit notifications
generated from new posts and comments. It doesn't delete any of the user's content or prevent them
from generating new content while limited. Users are not notified of their limits
in the UI, so if you want them to know about this, you must notify them.

## Path parameters

- `id` integer, required

## Response `204`

User successfully limited

## Other responses

- `401` — Unauthorized
- `404` — Unknown User ID

## Changes

- **2026-07-13** (v1) `7db6ba099285` — 2 breaking
  - removed the media type `application/json` for the response with the status `401`
  - removed the media type `application/json` for the response with the status `404`
- **2026-05-28** (v1) `6550ad7be94f` — 2 info
  - added the media type `application/json` for the response with the status `401`
  - added the media type `application/json` for the response with the status `404`
- **2026-03-03** (v1) `c9e7662755c2` — 2 breaking
  - removed the media type `application/json` for the response with the status `401`
  - removed the media type `application/json` for the response with the status `404`
- **2023-12-18** (v1) `1c81594090c0` — 2 info
  - added the media type `application/json` for the response with the status `401`
  - added the media type `application/json` for the response with the status `404`
- **2023-12-12** (v1) `3ab0f1109fb2` — 2 breaking
  - removed the media type `application/json` for the response with the status `401`
  - removed the media type `application/json` for the response with the status `404`

[Full history](https://skmtc.dev/forem/apis/forem-api-v1/changes/api/users/:id/limited/put.md)

---

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