---
title: "Update a member's role in an organization"
method: PATCH
path: "/api/v1/org/members/role"
tags: ["Organization Members"]
---

# Update a member's role in an organization

`PATCH /api/v1/org/members/role`

## Request

- Base URL: `https://platform-backend.getalchemystai.com`
- URL: `https://platform-backend.getalchemystai.com/api/v1/org/members/role`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/alchemyst-ai/apis/alchemyst-ai-api-v1-documentation/docs/api/v1/org/members/role/patch.ts> (a function with typed inputs; its response is checked against the schema)

Updates the role of a specific member within an organization. The user performing this action must be the 'owner' of the organization. The target member's role cannot be 'owner'.

## Request body

- object
  - `organizationId` string, required: The ID of the organization.
  - `memberId` string, required: The user ID of the member whose role is to be updated.
  - `role` 'member' | 'admin', required: The new role for the member.

## Response `200`

Role updated successfully.

- object
  - `message` string
  - `member` object
    - `userId` string
    - `role` string

## Other responses

- `400`: Bad Request - Missing required fields, invalid role, or invalid ID format.
- `401`: Unauthorized - User is not authenticated.
- `402`: Payment Required - User's subscription is not valid.
- `403`: Forbidden - User does not have 'owner' role, or is trying to change the role of an owner.
- `404`: Not Found - The target member was not found in the organization.
- `500`: Internal Server Error.

## Changes

- **2026-11-09** `2650e0435c8b`: 1 info
  - api operation id `updateOrgMemberRole` was added
- **2026-07-02** `056a116e2885`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/alchemyst-ai/apis/alchemyst-ai-api-v1-documentation/changes/api/v1/org/members/role/patch.md)

---

[API](https://skmtc.dev/alchemyst-ai/apis/alchemyst-ai-api-v1-documentation.md) - [All operations](https://skmtc.dev/alchemyst-ai/apis/alchemyst-ai-api-v1-documentation/llms.txt) - [OpenAPI document](https://skmtc.dev/alchemyst-ai/apis/alchemyst-ai-api-v1-documentation/revisions/2650e0435c8b?raw)