Skip to main content
Unary · Groups Shares a resource directly with a principal (user or service account). Use this method to:
  • Grant a user or service account direct access to a runner, project, or other resource
  • Share resources without creating and managing groups manually

Examples

  • Share a runner with a user: Grants admin access to a runner for a specific user.
  • Share a runner with a service account: Grants user access to a runner for a service account.

Authorization

Requires admin role on the specific resource.

Endpoint

Send a Bearer token as described in Authentication. If your organization uses a custom management-plane domain, replace https://app.ona.com with that domain.

Request example

Request

gitpod.v1.ShareResourceWithPrincipalRequest ShareResourceWithPrincipal messages

Response

gitpod.v1.ShareResourceWithPrincipalResponse This message has no fields.
ResourceRole represents roles that can be assigned to groups on resources These map directly to the roles defined in backend/db/rule/rbac/role/role.go