Sign in
Members

Update an organization member

Update a member's role within an organization. Requires manage permission (owner or admin). The organization owner's role cannot be changed.

patch/v1beta/organizations/{organization_id}/members/{user_id}

Path parameters

organization_idstring required

Organization the member belongs to. Pattern: org_[0-9a-hjkmnp-tv-z]{26}

Organization the member belongs to. Pattern: org_[0-9a-hjkmnp-tv-z]{26}

user_idstring required

User account ID of the member to update. Pattern: user_[0-9a-hjkmnp-tv-z]{26}

User account ID of the member to update. Pattern: user_[0-9a-hjkmnp-tv-z]{26}

Request body

role'owner' | 'admin' | 'member' required

Response

Success

Example response

{
  "member": {
    "user": {
      "id": "user_01h2xcejqtf2nbrexx3vqjhp41"
    }
  }
}

Changes

Changed in 2 of the 50 revisions of this API.27

  • 885f41a576395See the full diff
    • ○

      api tag Members added

      api-tag-added

    • ○

      api tag Organizations removed

      api-tag-removed

    • ○

      added the optional property member/user/family_name to the response with the 200 status

      response-optional-property-added

    • ○

      added the optional property member/user/given_name to the response with the 200 status

      response-optional-property-added

    • ○

      added the optional property member/user/profile_image_url to the response with the 200 status

      response-optional-property-added

  • a7e69986914e22See the full diff
    • ▲

      removed the required property member/email from the response with the 200 status

      response-required-property-removed

    • ▲

      removed the required property member/user/type from the response with the 200 status

      response-required-property-removed

    • ○

      the member/user/id response's property pattern was changed from ^(user|svc)_[0-9a-hjkmnp-tv-z]{26}$ to ^user_[0-9a-hjkmnp-tv-z]{26}$ for the status 200

      response-property-pattern-changed

    • ○

      added the required property member/user/email to the response with the 200 status

      response-required-property-added

    This revision also has 1 change that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog