---
title: "POST /restrictChatMember"
method: POST
path: "/restrictChatMember"
---

# POST /restrictChatMember

`POST /restrictChatMember`

Use this method to restrict a user in a supergroup. The bot must be an administrator in the supergroup for this to work and must have the appropriate admin rights. Pass *True* for all permissions to lift restrictions from a user. Returns *True* on success.

## Request body

- object
  - `chat_id` union, required — Unique identifier for the target chat or username of the target supergroup (in the format `@supergroupusername`)
    - integer
    - string
  - `user_id` integer, required — Unique identifier of the target user
  - `permissions` ChatPermissions, required — Describes actions that a non-administrator user is allowed to take in a chat.
    - `can_send_messages` boolean — *Optional*. True, if the user is allowed to send text messages, contacts, locations and venues
    - `can_send_media_messages` boolean — *Optional*. True, if the user is allowed to send audios, documents, photos, videos, video notes and voice notes, implies can\_send\_messages
    - `can_send_polls` boolean — *Optional*. True, if the user is allowed to send polls, implies can\_send\_messages
    - `can_send_other_messages` boolean — *Optional*. True, if the user is allowed to send animations, games, stickers and use inline bots, implies can\_send\_media\_messages
    - `can_add_web_page_previews` boolean — *Optional*. True, if the user is allowed to add web page previews to their messages, implies can\_send\_media\_messages
    - `can_change_info` boolean — *Optional*. True, if the user is allowed to change the chat title, photo and other settings. Ignored in public supergroups
    - `can_invite_users` boolean — *Optional*. True, if the user is allowed to invite new users to the chat
    - `can_pin_messages` boolean — *Optional*. True, if the user is allowed to pin messages. Ignored in public supergroups
  - `until_date` integer — Date when restrictions will be lifted for the user, unix time. If user is restricted for more than 366 days or less than 30 seconds from the current time, they are considered to be restricted forever

## Response `200`

- object
  - `ok` boolean, required
  - `result` boolean, required

## Other responses

- `default`

---

[API](https://skmtc.net/stoplight/apis/telegram-bot-api.md) · [All operations](https://skmtc.net/stoplight/apis/telegram-bot-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/stoplight/telegram-bot-api/versions/be4bbb34b64a/schema)