Update an app's role in a chat

Updates whether an app is an administrator of the chat. An app holds a role exactly as a user does, so a bot administers a chat on the same terms, and role is the only field an app has to update: it carries no read position, favourite flag or inbox state. role is required and the app must already be a member. Returns the updated member, always with an @type of app, since the variant follows the member updated rather than the caller. Supplying the role it already holds is a no-op that returns it unchanged.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
string
required

Globally unique identifier for a chat; a c- prefixed string.

string
required

Globally unique identifier for an app identity; an aid- prefixed string.

Body Params

Parameters for updating a member's role within a chat.

string
enum
required

The role of a member within a chat, which determines what management actions they are able to take on the chat.

Allowed:
Headers
string
enum
Defaults to application/json

Generated from available response content types

Allowed:
Responses

Language
Credentials
Bearer
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json
application/problem+json