IPermissionClient

Implemented by

• PermissionClient

Index

Methods

• addGroupMember
• deleteGroup
• getUser
• listGroupMembers
• listGroups
• listUserGroups
• listUsers
• putGroup
• removeGroupMember

Methods

addGroupMember

• addGroupMember(groupId: string, userId: string, signal?: AbortSignal): Promise<GroupMember>

• Parameters

  • groupId: string

  • userId: string

  • optionalsignal: AbortSignal

  Returns Promise<GroupMember>

deleteGroup

• deleteGroup(id: string, request: DeleteGroupRequest, signal?: AbortSignal): Promise<Group>

• Parameters

  • id: string

  • request: DeleteGroupRequest

  • optionalsignal: AbortSignal

  Returns Promise<Group>

getUser

• getUser(userId: string, options?: GetUserOptions, signal?: AbortSignal): Promise<User>

• Gets a single user by their unique ID. Soft-deleted users are reported as not found unless includeDeleted is set.

  @throws

  When no such user exists, or the user is soft-deleted and includeDeleted is false (404).

  @throws

  On insufficient permissions, including includeDeleted without global Edit (403).

  ---

  Parameters

  • userId: string

  • optionaloptions: GetUserOptions

  • optionalsignal: AbortSignal

  Returns Promise<User>

listGroupMembers

• listGroupMembers(groupId: string, page?: string, limit?: number, signal?: AbortSignal): Promise<PaginatedResponse<User>>

• Parameters

  • groupId: string

  • optionalpage: string

  • optionallimit: number

  • optionalsignal: AbortSignal

  Returns Promise<PaginatedResponse<User>>

listGroups

• listGroups(page?: string, limit?: number, q?: string, signal?: AbortSignal): Promise<PaginatedResponse<Group>>

• Parameters

  • optionalpage: string

  • optionallimit: number

  • optionalq: string

  • optionalsignal: AbortSignal

  Returns Promise<PaginatedResponse<Group>>

listUserGroups

• listUserGroups(userId: string, page?: string, limit?: number, signal?: AbortSignal): Promise<PaginatedResponse<Group>>

• Parameters

  • userId: string

  • optionalpage: string

  • optionallimit: number

  • optionalsignal: AbortSignal

  Returns Promise<PaginatedResponse<Group>>

listUsers

• listUsers(options?: ListUsersOptions, signal?: AbortSignal): Promise<PaginatedResponse<User>>
• listUsers(page?: string, limit?: number, q?: string, signal?: AbortSignal): Promise<PaginatedResponse<User>>

• Lists users with keyset pagination and optional filters. q is a case-insensitive fuzzy search across external username, email, first and last name; externalUsername and email are case-insensitive exact matches. All filters are AND-combined.

  @throws

  On invalid pagination token, out-of-range limit, or too-long filter (400).

  @throws

  On insufficient permissions, including includeDeleted without global Edit (403).

  ---

  Parameters

  • optionaloptions: ListUsersOptions

  • optionalsignal: AbortSignal

  Returns Promise<PaginatedResponse<User>>

putGroup

• putGroup(id: string, request: PutGroupRequest, signal?: AbortSignal): Promise<Group>

• Parameters

  • id: string

  • request: PutGroupRequest

  • optionalsignal: AbortSignal

  Returns Promise<Group>

removeGroupMember

• removeGroupMember(groupId: string, userId: string, signal?: AbortSignal): Promise<GroupMember>

• Parameters

  • groupId: string

  • userId: string

  • optionalsignal: AbortSignal

  Returns Promise<GroupMember>