v18

latestOpenAPI 3.0.0raw.githubusercontent.com2026-08-014211,6201.8 MB
gitpod.v1.OrganizationService

SetRole

Manages organization membership and roles by setting a user's role within the organization.

Use this method to:

  • Promote members to admin role
  • Change member permissions
  • Demote admins to regular members

Examples

  • Promote to admin:

    Makes a user an organization administrator.

    organizationId: "b0e12f6c-4c67-429d-a4a6-d9838b5da047"
    userId: "f53d2330-3795-4c5d-a1f3-453121af9c60"
    role: ORGANIZATION_ROLE_ADMIN
    
  • Change to member:

    Changes a user's role to regular member.

    organizationId: "b0e12f6c-4c67-429d-a4a6-d9838b5da047"
    userId: "f53d2330-3795-4c5d-a1f3-453121af9c60"
    role: ORGANIZATION_ROLE_MEMBER
    
post/gitpod.v1.OrganizationService/SetRole

Request body

organizationIdstring uuid required
role'ORGANIZATION_ROLE_UNSPECIFIED' | 'ORGANIZATION_ROLE_ADMIN' | 'ORGANIZATION_ROLE_MEMBER'
userIdstring uuid required

Response

Success

GitpodV1SetRoleResponse required