---
title: "Update a member"
method: PATCH
path: "/members/{id}"
tags: ["Members"]
---

# Update a member

`PATCH /members/{id}`

## Request

- Base URL: `https://www.happyscribe.com/api/v1`
- URL: `https://www.happyscribe.com/api/v1/members/{id}`
- Auth: API key in header `Authorization`

Changes the member's name. The member's policy changes through `PATCH /policies/{id}`.

## Request body

- MemberUpdate
  - `name` string: The member's new name.
  - `metadata` union: Merged into the object's metadata: the keys you send are added or overwritten and the others kept. `""` as a value removes that key; `metadata: ""` removes every key. Numbers and booleans are stored as their text; objects, arrays and `null` are refused.
    - object
    - ''

## Response `200`

The updated member.

- Member
  - `id` string: Stable typed member ID beginning with `mem_`. Treat it as an opaque string.
  - `object` string: Always `member`.
  - `workspace_id` string: Workspace ID, beginning with `wks_`. Treat it as an opaque string.
  - `email` string, email: The member's email, unique within the workspace.
  - `name` string, nullable: `null` for a person who also has workspaces of their own: their name is theirs.
  - `metadata` Metadata: Your own key-value pairs, for your ids and context. HappyScribe stores them, returns them on the object and in every webhook that carries it, and never acts on them. Up to 50 keys of up to 40 characters (no square brackets), values up to 500 characters. See [metadata](/meetingkit/setup#a-workspace-per-customer).
  - `created_at` string, date-time: When the member was created, in ISO 8601.

## Other responses

- `401`: Missing or invalid API key, or the key is not an owner or admin of the workspace.
- `404`: No such member in a workspace the key belongs to.
- `422`: Invalid or missing `name`, or a `name` for a person who also belongs to other workspaces (`shared_account`): their name is theirs.

---

[API](https://skmtc.dev/happyscribe/apis/happyscribe-api.md) - [All operations](https://skmtc.dev/happyscribe/apis/happyscribe-api/llms.txt) - [OpenAPI document](https://skmtc.dev/happyscribe/apis/happyscribe-api/revisions/1281bd968c3d?raw)
