---
title: "Update organization user role in a zone"
method: PATCH
path: "/zones/{zoneId}/members/{organizationUserId}"
tags: ["Zone Members"]
---

# Update organization user role in a zone

`PATCH /zones/{zoneId}/members/{organizationUserId}`

Updates the role of an existing zone member. Only organization administrators can perform this action.

## Path parameters

- `zoneId` string, required
- `organizationUserId` string, required

## Request body

- IamZoneMemberUpdate — Schema for updating an organization user's role in a zone
  - `role` 'zone_manager' | 'zone_viewer', required — Zone role type. zone_manager has full management access, zone_viewer has read-only access.

## Response `200`

Represents an organization user's membership in a zone with an assigned role

- IamZoneMember — Represents an organization user's membership in a zone with an assigned role
  - `id` string, required — Unique identifier of the zone member
  - `organization_user_id` string, required — Organization user ID of the zone member
  - `zone_id` string, required — Zone ID the organization user is a member of
  - `organization_id` string, required — Organization ID that owns the zone
  - `role` 'zone_manager' | 'zone_viewer', required — Zone role type. zone_manager has full management access, zone_viewer has read-only access.
  - `created_at` string, date-time, required — Entity creation timestamp
  - `updated_at` string, date-time, required — Entity update timestamp
  - `_links` IamZoneMemberLinks, required — HAL-format hypermedia links for zone member resources
    - `self` object, required
      - `href` string, uri-reference, required — Link to this zone member resource
    - `organization_user` object, required
      - `href` string, uri-reference, required — Link to the user resource

## Other responses

- `default` — Error response

---

[API](https://skmtc.net/keycardai/apis/untitled-api.md) · [All operations](https://skmtc.net/keycardai/apis/untitled-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/keycardai/untitled-api/revisions/2f5033ed4491/schema)