Skip to content
Scalekit Docs
Talk to an EngineerDashboard

Permissions

Manage fine-grained permissions

Use the permission client to define fine-grained permissions that roles can grant.

Model permissions for resources in your app, then attach them to roles.

clientPermissionshttps://github.com/scalekit-inc/scalekit-sdk-go/blob/main/permission.go
#asyncCreatePermission

CreatePermission creates a new permission

paramctxcontext.Context

Request context

parampermissionrolesv1.CreatePermission

Permission creation payload.

returnsCreatePermissionResponse

The created resource.

clientPermissionshttps://github.com/scalekit-inc/scalekit-sdk-go/blob/main/permission.go
#asyncGetPermission

GetPermission retrieves a permission by name

paramctxcontext.Context

Request context

parampermissionNamestring

Permission name.

returnsGetPermissionResponse

The response payload for this operation.

clientPermissionshttps://github.com/scalekit-inc/scalekit-sdk-go/blob/main/permission.go
#asyncListPermissions

ListPermissions lists all permissions with optional pagination.

paramctxcontext.Context

Request context

parampageTokenstring

Page token.

parampageSizeuint32

Page size.

returnsListPermissionsResponse

Paginated results.

clientPermissionshttps://github.com/scalekit-inc/scalekit-sdk-go/blob/main/permission.go
#asyncUpdatePermission

UpdatePermission updates an existing permission by name

paramctxcontext.Context

Request context

parampermissionNamestring

Permission name.

parampermissionrolesv1.CreatePermission

Permission update payload.

returnsUpdatePermissionResponse

The updated resource.

clientPermissionshttps://github.com/scalekit-inc/scalekit-sdk-go/blob/main/permission.go
#asyncDeletePermission

DeletePermission deletes a permission by name

paramctxcontext.Context

Request context

parampermissionNamestring

Permission name.

returnserror

error

clientPermissionshttps://github.com/scalekit-inc/scalekit-sdk-go/blob/main/permission.go
#asyncListRolePermissions

ListRolePermissions lists all permissions associated with a role

paramctxcontext.Context

Request context

paramroleNamestring

Role name.

returnsListRolePermissionsResponse

Paginated results.

clientPermissionshttps://github.com/scalekit-inc/scalekit-sdk-go/blob/main/permission.go
#asyncAddPermissionsToRole

AddPermissionsToRole adds permissions to a role

paramctxcontext.Context

Request context

paramroleNamestring

Role name.

parampermissionNames[]string

Permission names.

returnsAddPermissionsToRoleResponse

The created resource.

clientPermissionshttps://github.com/scalekit-inc/scalekit-sdk-go/blob/main/permission.go
#asyncRemovePermissionFromRole

RemovePermissionFromRole removes a permission from a role

paramctxcontext.Context

Request context

paramroleNamestring

Role name.

parampermissionNamestring

Permission name.

returnserror

error

clientPermissionshttps://github.com/scalekit-inc/scalekit-sdk-go/blob/main/permission.go
#asyncListEffectiveRolePermissions

ListEffectiveRolePermissions lists all effective permissions for a role (including inherited permissions)

paramctxcontext.Context

Request context

paramroleNamestring

Role name.

returnsListEffectiveRolePermissionsResponse

Paginated results.