---
title: "PATCH /api/v1/team/members/{memberId}"
method: PATCH
path: "/api/v1/team/members/{memberId}"
tags: ["team"]
---

# PATCH /api/v1/team/members/{memberId}

`PATCH /api/v1/team/members/{memberId}`

## Request

- Base URL: `https://api.clerkchat.co` (the document declares no server; this is the origin it was published from)
- URL: `https://api.clerkchat.co/api/v1/team/members/{memberId}`
- Auth: none required

## Path parameters

- `memberId` string, required

## Request body

- object
  - `role` 'owner' | 'admin' | 'manager' | 'member', nullable
  - `agentAccess` union
    - object
      - `scope` 'all', required
    - object
      - `scope` 'selected', required
      - `agentIds` string[], required

## Response `200`

TeamReadModel

- TeamReadModelEncoded
  - `members` TeamMemberEncoded[], required
    - `id` string, required
    - `userId` string, required
    - `name` string, required
    - `email` string, required
    - `role` 'owner' | 'admin' | 'manager' | 'member', required
    - `createdAt` union, required
      - number
      - 'Infinity' | '-Infinity' | 'NaN'
    - `agentAccess` union, required
      - object
        - `scope` 'all', required
      - object
        - `scope` 'selected', required
        - `agentIds` string[], required
  - `invitations` TeamInvitationEncoded[], required
    - `id` string, required
    - `email` string, required
    - `role` 'owner' | 'admin' | 'manager' | 'member', required
    - `status` string, required
    - `inviterId` string, required
    - `createdAt` union, required
      - number
      - 'Infinity' | '-Infinity' | 'NaN'
    - `expiresAt` union, required
      - number
      - 'Infinity' | '-Infinity' | 'NaN'
    - `agentAccess` union, required
      - object
        - `scope` 'all', required
      - object
        - `scope` 'selected', required
        - `agentIds` string[], required

## Other responses

- `400`: BadRequest
- `401`: Unauthorized
- `403`: Forbidden
- `404`: NotFound
- `409`: Conflict
- `503`: PersistenceUnavailable

---

[API](https://skmtc.dev/clerkchat/apis/clerk-chat-api.md) · [All operations](https://skmtc.dev/clerkchat/apis/clerk-chat-api/llms.txt) · [OpenAPI document](https://skmtc.dev/clerkchat/apis/clerk-chat-api/revisions/cc318e39e1d0?raw)