node-zendesk • Docs
node-zendesk / clients/core/permissiongroups / PermissionGroups
Class: PermissionGroups
Client for the Zendesk Permission Groups API.
See
https://developer.zendesk.com/api-reference/help_center/help-center-api/permission_groups/
Extends
Constructors
new PermissionGroups()
new PermissionGroups(
options):PermissionGroups
Parameters
• options: any
Returns
Overrides
Defined in
clients/core/permissiongroups.d.ts:6
Properties
_transporter
_transporter:
Transporter
Inherited from
Defined in
clients/client.d.ts:42
eventTarget
eventTarget:
CustomEventTarget
Event target to handle custom events.
Inherited from
Defined in
clients/client.d.ts:40
jsonAPINames
jsonAPINames:
string[]
Array to hold names used in the JSON API.
Overrides
Defined in
clients/core/permissiongroups.d.ts:7
options
options:
ZendeskClientOptions&object
Configuration options for the client.
Type declaration
get()
get: (
key) =>any
Parameters
• key: string
Returns
any
Inherited from
Defined in
clients/client.d.ts:34
sideLoad
sideLoad:
any[]
Array to handle side-loaded resources.
Inherited from
Defined in
clients/client.d.ts:37
useDotJson
useDotJson:
boolean
Flag to indicate if the API endpoint should use '.json' ending.
Inherited from
Defined in
clients/client.d.ts:39
Accessors
transporter
Get Signature
get transporter():
Transporter
Returns
Transporter for making requests.
Inherited from
Defined in
clients/client.d.ts:41
Methods
_rawRequest()
_rawRequest(
method,uri, ...arguments_):Promise<object>
Parameters
• method: any
• uri: any
• ...arguments_: any[]
Returns
Promise<object>
response
response:
any
result
result:
object
Inherited from
Defined in
clients/client.d.ts:78
create()
create(
group):Promise<object>
Create a new permission group.
Parameters
• group
The permission group details.
• group.edit?: number[]
Array of user segments that have edit privileges.
• group.name: string
Name of the permission group.
• group.publish?: number[]
Array of user segments that have publish privileges.
Returns
Promise<object>
Newly created permission group object.
response
response:
object
result
result:
object
Throws
Throws an error if the API call fails.
See
Example
const newGroup = await client.permissiongroups.create({
name: "Printer Experts",
edit: [12],
publish: [34]
});Defined in
clients/core/permissiongroups.d.ts:46
delete()
delete(
groupID):Promise<void>
Delete a permission group.
Parameters
• groupID: number
The ID of the permission group.
Returns
Promise<void>
Throws
Throws an error if the API call fails.
See
Example
await client.permissiongroups.delete(42);Overrides
Defined in
clients/core/permissiongroups.d.ts:86
emit()
emit(
eventType,eventData):void
Parameters
• eventType: any
• eventData: any
Returns
void
Inherited from
Defined in
clients/client.d.ts:43
get()
get(
resource):Promise<NodeModule>
Parameters
• resource: any
Returns
Promise<NodeModule>
Inherited from
Defined in
clients/client.d.ts:62
getAll()
getAll(
resource):Promise<any[]>
Parameters
• resource: any
Returns
Promise<any[]>
Inherited from
Defined in
clients/client.d.ts:77
list()
list():
Promise<object[]>
List all permission groups.
Returns
Promise<object[]>
Array of permission group objects.
Throws
Throws an error if the API call fails.
See
Example
const groups = await client.permissiongroups.list();Defined in
clients/core/permissiongroups.d.ts:16
on()
on(
eventType,callback):void
Parameters
• eventType: any
• callback: any
Returns
void
Inherited from
Defined in
clients/client.d.ts:44
patch()
patch(...
arguments_):Promise<void|object>
Patches a resource.
Parameters
• ...arguments_: any[]
The resources or parts of the resource path followed by the body.
Returns
Promise<void | object>
- Either void or response object
Inherited from
Defined in
clients/client.d.ts:68
post()
post(
resource,body):Promise<NodeModule>
Parameters
• resource: any
• body: any
Returns
Promise<NodeModule>
Inherited from
Defined in
clients/client.d.ts:70
put()
put(
resource,body):Promise<NodeModule>
Parameters
• resource: any
• body: any
Returns
Promise<NodeModule>
Inherited from
Defined in
clients/client.d.ts:69
request()
request<
T>(method,uri, ...arguments_):Promise<NodeModule>
Request method that handles various HTTP methods.
Type Parameters
• T
Parameters
• method: string
HTTP method (e.g., 'GET', 'POST').
• uri: string
The URI for the request.
• ...arguments_: any[]
Additional arguments for the request.
Returns
Promise<NodeModule>
- The API response.
Inherited from
Defined in
clients/client.d.ts:96
requestAll()
requestAll(
method,uri, ...arguments_):Promise<any[]>
Parameters
• method: any
• uri: any
• ...arguments_: any[]
Returns
Promise<any[]>
Inherited from
Defined in
clients/client.d.ts:97
requestUpload()
requestUpload(
uri,file):Promise<any>
Parameters
• uri: any
• file: any
Returns
Promise<any>
Inherited from
Defined in
clients/client.d.ts:98
setSideLoad()
setSideLoad(
array):void
Parameters
• array: any
Returns
void
Inherited from
Defined in
clients/client.d.ts:61
show()
show(
groupID):Promise<object>
Retrieve details of a specific permission group.
Parameters
• groupID: number
The ID of the permission group.
Returns
Promise<object>
Permission group object.
response
response:
object
result
result:
object
Throws
Throws an error if the API call fails.
See
Example
const group = await client.permissiongroups.show(42);Defined in
clients/core/permissiongroups.d.ts:26
update()
update(
groupID,group):Promise<object>
Update an existing permission group.
Parameters
• groupID: number
The ID of the permission group.
• group
The permission group details to update.
• group.edit?: number[]
Array of user segments that have edit privileges.
• group.name?: string
Name of the permission group.
• group.publish?: number[]
Array of user segments that have publish privileges.
Returns
Promise<object>
Updated permission group object.
response
response:
object
result
result:
object
Throws
Throws an error if the API call fails.
See
Example
const updatedGroup = await client.permissiongroups.update(42, {
name: "Super Printer Experts"
});Defined in
clients/core/permissiongroups.d.ts:69