---
search:
  tags:
    - AppShares
    - PATCH
seo:
  description: >-
    User-gated (chrm_user_* or session); owner only (app:share). Re-roles an…
    Reference for the PATCH /api/v1/apps/{appId}/shares endpoint in the Charming
    API.
sidebar:
  label: Change an existing share’s role by grantee
  badge: PATCH
title: Change an existing share’s role by grantee
type: openapi-operation
---
User-gated (`chrm_user_*` or session); owner only (`app:share`). Re-roles an existing grant or outstanding email invitation; never creates one.

`PATCH /api/v1/apps/{appId}/shares`

Found a bug or need a feature? [Tell us](/docs/capabilities/feedback) with `submit_feedback` or `POST /app/{id}/feedback`. Your feedback shapes what we build next.