---
title: "Update a member's role"
method: PATCH
path: "/orgs/{org_id}/members/{user_id}"
tags: ["Organizations"]
---

# Update a member's role

`PATCH /orgs/{org_id}/members/{user_id}`

## Request

- Base URL: `https://api-docs.jackhamr.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api-docs.jackhamr.ai/orgs/{org_id}/members/{user_id}`
- Auth: none declared

Change a member's role in the organization.

Requires the ``owner`` org role. The org Owner's own role cannot
be changed via this endpoint (ownership transfer is a separate
flow). 404 when the org or member does not exist.

## Path parameters

- `org_id` string, required
- `user_id` string, required

## Request body

- OrgMemberUpdate: Request body for ``PATCH /api/v1/orgs/{id}/members/{user_id}``.
  - `role` string, required

## Response `200`

Successful Response

- OrgMemberOut: An organization member.
  - `id` string, required
  - `organization_id` string, required
  - `user_id` string, required
  - `role` string, required
  - `user_email` string, nullable
  - `user_full_name` string, nullable
  - `created_at` string, date-time, required
  - `updated_at` string, date-time, required

## Other responses

- `422`: Validation Error

---

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