Skip to content

node-zendeskDocs


node-zendesk / clients/helpcenter/categories / Categories

Class: Categories

Categories are the top-level organizing containers of the knowledge base in the help center

Extends

Constructors

new Categories()

new Categories(options): Categories

Parameters

options: any

Returns

Categories

Overrides

Client.constructor

Defined in

clients/helpcenter/categories.d.ts:66

Properties

_transporter

_transporter: Transporter

Inherited from

Client._transporter

Defined in

clients/client.d.ts:42


eventTarget

eventTarget: CustomEventTarget

Event target to handle custom events.

Inherited from

Client.eventTarget

Defined in

clients/client.d.ts:40


jsonAPINames

jsonAPINames: string[]

Array to hold names used in the JSON API.

Overrides

Client.jsonAPINames

Defined in

clients/helpcenter/categories.d.ts:67


options

options: ZendeskClientOptions & object

Configuration options for the client.

Type declaration

get()

get: (key) => any

Parameters

key: string

Returns

any

Inherited from

Client.options

Defined in

clients/client.d.ts:34


sideLoad

sideLoad: any[]

Array to handle side-loaded resources.

Inherited from

Client.sideLoad

Defined in

clients/client.d.ts:37


useDotJson

useDotJson: boolean

Flag to indicate if the API endpoint should use '.json' ending.

Inherited from

Client.useDotJson

Defined in

clients/client.d.ts:39

Accessors

transporter

Get Signature

get transporter(): Transporter

Returns

Transporter

Transporter for making requests.

Inherited from

Client.transporter

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

Client._rawRequest

Defined in

clients/client.d.ts:78


create()

create(category): Promise<NodeModule>

Parameters

category: any

Returns

Promise<NodeModule>

Defined in

clients/helpcenter/categories.d.ts:94


delete()

delete(categoryID): Promise<any>

Deletes a resource.

Parameters

categoryID: any

Returns

Promise<any>

  • Either void or response object

Overrides

Client.delete

Defined in

clients/helpcenter/categories.d.ts:98


emit()

emit(eventType, eventData): void

Parameters

eventType: any

eventData: any

Returns

void

Inherited from

Client.emit

Defined in

clients/client.d.ts:43


get()

get(resource): Promise<NodeModule>

Parameters

resource: any

Returns

Promise<NodeModule>

Inherited from

Client.get

Defined in

clients/client.d.ts:62


getAll()

getAll(resource): Promise<any[]>

Parameters

resource: any

Returns

Promise<any[]>

Inherited from

Client.getAll

Defined in

clients/client.d.ts:77


list()

list(): Promise<Category[]>

List all the categories

Returns

Promise<Category[]>

An array of categories

See

https://developer.zendesk.com/api-reference/help_center/help-center-api/categories/#list-categories

Example

ts
const categories = await client.helpcenter.categories.list();

Defined in

clients/helpcenter/categories.d.ts:75


listWithLocale()

listWithLocale(locale): Promise<Category[]>

List all the categories

Parameters

locale: string

The locale to filter categories by

Returns

Promise<Category[]>

An array of categories

See

https://developer.zendesk.com/api-reference/help_center/help-center-api/categories/#list-categories

Example

ts
const categories = await client.helpcenter.categories.listWithLocale('en-us');

Defined in

clients/helpcenter/categories.d.ts:84


on()

on(eventType, callback): void

Parameters

eventType: any

callback: any

Returns

void

Inherited from

Client.on

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

Client.patch

Defined in

clients/client.d.ts:68


post()

post(resource, body): Promise<NodeModule>

Parameters

resource: any

body: any

Returns

Promise<NodeModule>

Inherited from

Client.post

Defined in

clients/client.d.ts:70


put()

put(resource, body): Promise<NodeModule>

Parameters

resource: any

body: any

Returns

Promise<NodeModule>

Inherited from

Client.put

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

Client.request

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

Client.requestAll

Defined in

clients/client.d.ts:97


requestUpload()

requestUpload(uri, file): Promise<any>

Parameters

uri: any

file: any

Returns

Promise<any>

Inherited from

Client.requestUpload

Defined in

clients/client.d.ts:98


setSideLoad()

setSideLoad(array): void

Parameters

array: any

Returns

void

Inherited from

Client.setSideLoad

Defined in

clients/client.d.ts:61


show()

show(categoryID): Promise<Category>

Get a specific category

Parameters

categoryID: number

The ID of the category to retrieve

Returns

Promise<Category>

An array of categories

See

https://developer.zendesk.com/api-reference/help_center/help-center-api/categories/#show-category

Example

ts
const categories = await client.helpcenter.categories.show(12345678);

Defined in

clients/helpcenter/categories.d.ts:93


update()

update(categoryID, category): Promise<NodeModule>

Parameters

categoryID: any

category: any

Returns

Promise<NodeModule>

Defined in

clients/helpcenter/categories.d.ts:95


updateSourceLocale()

updateSourceLocale(categoryID, sourceLocale): Promise<NodeModule>

Parameters

categoryID: any

sourceLocale: any

Returns

Promise<NodeModule>

Defined in

clients/helpcenter/categories.d.ts:97


updateWithLocale()

updateWithLocale(locale, categoryID, category): Promise<NodeModule>

Parameters

locale: any

categoryID: any

category: any

Returns

Promise<NodeModule>

Defined in

clients/helpcenter/categories.d.ts:96

Released under the MIT License.