---
title: "Edit Member"
method: PATCH
path: "/servers/{server_id}/members/{member_id}"
tags: ["Server Members"]
---

# Edit Member

`PATCH /servers/{server_id}/members/{member_id}`

Edit a member by their id.

## Path parameters

- `server_id` string, required
- `member_id` string, required

## Headers

- `X-Audit-Log-Reason` string

## Request body

- DataMemberEdit — New member information
  - `nickname` string, nullable — Member nickname
  - `pronouns` string, nullable — Member pronouns
  - `avatar` string, nullable — Attachment Id to set for avatar
  - `roles` string[], nullable — Array of role ids
  - `timeout` string, date-time — ISO8601 formatted timestamp
  - `can_publish` boolean, nullable — server-wide voice muted
  - `can_receive` boolean, nullable — server-wide voice deafened
  - `voice_channel` string, nullable — voice channel to move to if already in a voice channel
  - `remove` FieldsMember[] — Fields to remove from channel object

## Response `200`

- Member — Server Member
  - `_id` MemberCompositeKey, required — Composite primary key consisting of server and user id
    - `server` string, required — Server Id
    - `user` string, required — User Id
  - `joined_at` string, date-time, required — ISO8601 formatted timestamp
  - `nickname` string, nullable — Member's nickname
  - `pronouns` string, nullable — Member's pronouns
  - `avatar` File — File
    - `_id` string, required — Unique Id
    - `tag` string, required — Tag / bucket this file was uploaded to
    - `filename` string, required — Original filename
    - `metadata` union, required — Metadata associated with a file
      - object — File is just a generic uncategorised file
        - `type` 'File', required
      - object — File contains textual data and should be displayed as such
        - `type` 'Text', required
      - object — File is an image with specific dimensions, and may be animated
        - `type` 'Image', required
        - `width` integer, required
        - `height` integer, required
        - `thumbhash` integer[], nullable
        - `animated` boolean, nullable
      - object — File is a video with specific dimensions
        - `type` 'Video', required
        - `width` integer, required
        - `height` integer, required
      - object — File is audio
        - `type` 'Audio', required
    - `content_type` string, required — Raw content type of this file
    - `size` integer, required — Size of this file (in bytes)
    - `deleted` boolean, nullable — Whether this file was deleted
    - `reported` boolean, nullable — Whether this file was reported
    - `message_id` string, nullable
    - `user_id` string, nullable
    - `server_id` string, nullable
    - `object_id` string, nullable — Id of the object this file is associated with
  - `roles` string[] — Member's roles
  - `timeout` string, date-time — ISO8601 formatted timestamp
  - `can_publish` boolean — Whether the member is server-wide voice muted
  - `can_receive` boolean — Whether the member is server-wide voice deafened

## 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)