node-zendesk / Exports / clients/core/useridentities / UserIdentities

Class: UserIdentities

clients/core/useridentities.UserIdentities

Client for interacting with the Zendesk User Identities API.

See

https://developer.zendesk.com/api-reference/ticketing/users/user_identities/

Hierarchy

• Client

  ↳ UserIdentities

Table of contents

Constructors

• constructor

Properties

• _transporter
• eventTarget
• jsonAPINames
• options
• sideLoad
• useDotJson

Accessors

• transporter

Methods

• _rawRequest
• create
• delete
• emit
• get
• getAll
• list
• makePrimary
• on
• patch
• post
• put
• request
• requestAll
• requestUpload
• requestVerification
• setSideLoad
• show
• update
• verify

Constructors

constructor

• new UserIdentities(options): UserIdentities

Parameters

Name	Type
options	any

Returns

UserIdentities

Overrides

Client.constructor

Defined in

clients/core/useridentities.d.ts:6

Properties

_transporter

• _transporter: Transporter

Inherited from

Client._transporter

Defined in

clients/client.d.ts:94

---

eventTarget

• eventTarget: CustomEventTarget

Event target to handle custom events.

Inherited from

Client.eventTarget

Defined in

clients/client.d.ts:92

---

jsonAPINames

• jsonAPINames: string[]

Array to hold names used in the JSON API.

Overrides

Client.jsonAPINames

Defined in

clients/core/useridentities.d.ts:7

---

options

• options: ClientOptions & { get: (key: string) => any }

Configuration options for the client.

Inherited from

Client.options

Defined in

clients/client.d.ts:86

---

sideLoad

• sideLoad: any[]

Array to handle side-loaded resources.

Inherited from

Client.sideLoad

Defined in

clients/client.d.ts:89

---

useDotJson

• useDotJson: boolean

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

Inherited from

Client.useDotJson

Defined in

clients/client.d.ts:91

Accessors

transporter

• get transporter(): Transporter

Transporter for making requests.

Returns

Transporter

Inherited from

Client.transporter

Defined in

clients/client.d.ts:93

Methods

_rawRequest

▸ _rawRequest(method, uri, ...args): Promise<{ response: any ; result: {} }>

Parameters

Name	Type
method	any
uri	any
...args	any[]

Returns

Promise<{ response: any ; result: {} }>

Inherited from

Client._rawRequest

Defined in

clients/client.d.ts:130

---

create

▸ create(userId, userIdentity): Promise<object>

Create a new identity for a given user.

Parameters

Name	Type	Description
userId	number	The ID of the user.
userIdentity	object	The user identity details to create.

Returns

Promise<object>

The created user identity.

Async

Throws

Throws an error if the request fails.

See

https://developer.zendesk.com/api-reference/ticketing/users/user_identities/#create-identity

Example

const newIdentity = await client.useridentities.create(12345, {type: 'email', value: 'test@example.com'});

Defined in

clients/core/useridentities.d.ts:39

---

delete

▸ delete(userId, userIdentityId): Promise<void>

Delete a specific identity for a given user.

Parameters

Name	Type	Description
userId	number	The ID of the user.
userIdentityId	number	The ID of the user identity to delete.

Returns

Promise<void>

Async

Throws

Throws an error if the request fails.

See

https://developer.zendesk.com/api-reference/ticketing/users/user_identities/#delete-identity

Example

await client.useridentities.delete(12345, 67890);

Overrides

Client.delete

Defined in

clients/core/useridentities.d.ts:95

---

emit

▸ emit(eventType, eventData): void

Parameters

Name	Type
eventType	any
eventData	any

Returns

void

Inherited from

Client.emit

Defined in

clients/client.d.ts:95

---

get

▸ get(resource): Promise<NodeModule>

Parameters

Name	Type
resource	any

Returns

Promise<NodeModule>

Inherited from

Client.get

Defined in

clients/client.d.ts:114

---

getAll

▸ getAll(resource): Promise<any[]>

Parameters

Name	Type
resource	any

Returns

Promise<any[]>

Inherited from

Client.getAll

Defined in

clients/client.d.ts:129

---

list

▸ list(userId): Promise<object[]>

List all identities for a given user.

Parameters

Name	Type	Description
userId	number	The ID of the user.

Returns

Promise<object[]>

A list of user identities.

Async

Throws

Throws an error if the request fails.

See

https://developer.zendesk.com/api-reference/ticketing/users/user_identities/#list-identities

Example

const identities = await client.useridentities.list(12345);

Defined in

clients/core/useridentities.d.ts:17

---

makePrimary

▸ makePrimary(userId, userIdentityId): Promise<object>

Make a specific identity the primary identity for a given user.

Parameters

Name	Type	Description
userId	number	The ID of the user.
userIdentityId	number	The ID of the user identity to make primary.

Returns

Promise<object>

The updated user identity.

Async

Throws

Throws an error if the request fails.

See

https://developer.zendesk.com/api-reference/ticketing/users/user_identities/#make-identity-primary

Example

await client.useridentities.makePrimary(12345, 67890);

Defined in

clients/core/useridentities.d.ts:62

---

on

▸ on(eventType, callback): void

Parameters

Name	Type
eventType	any
callback	any

Returns

void

Inherited from

Client.on

Defined in

clients/client.d.ts:96

---

patch

▸ patch(...args): Promise<void | object>

Patches a resource.

Parameters

Name	Type	Description
...args	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:120

---

post

▸ post(resource, body): Promise<NodeModule>

Parameters

Name	Type
resource	any
body	any

Returns

Promise<NodeModule>

Inherited from

Client.post

Defined in

clients/client.d.ts:122

---

put

▸ put(resource, body): Promise<NodeModule>

Parameters

Name	Type
resource	any
body	any

Returns

Promise<NodeModule>

Inherited from

Client.put

Defined in

clients/client.d.ts:121

---

request

▸ request<T>(method, uri, ...args): Promise<NodeModule>

Request method that handles various HTTP methods.

Type parameters

Name
T

Parameters

Name	Type	Description
method	string	HTTP method (e.g., 'GET', 'POST').
uri	string	The URI for the request.
...args	any[]	Additional arguments for the request.

Returns

Promise<NodeModule>

• The API response.

Inherited from

Client.request

Defined in

clients/client.d.ts:148

---

requestAll

▸ requestAll(method, uri, ...args): Promise<any[]>

Parameters

Name	Type
method	any
uri	any
...args	any[]

Returns

Promise<any[]>

Inherited from

Client.requestAll

Defined in

clients/client.d.ts:149

---

requestUpload

▸ requestUpload(uri, file): Promise<any>

Parameters

Name	Type
uri	any
file	any

Returns

Promise<any>

Inherited from

Client.requestUpload

Defined in

clients/client.d.ts:150

---

requestVerification

▸ requestVerification(userId, userIdentityId): Promise<object>

Request verification for a specific identity for a given user.

Parameters

Name	Type	Description
userId	number	The ID of the user.
userIdentityId	number	The ID of the user identity to request verification for.

Returns

Promise<object>

The user identity verification request details.

Async

Throws

Throws an error if the request fails.

See

https://developer.zendesk.com/api-reference/ticketing/users/user_identities/#request-user-verification

Example

await client.useridentities.requestVerification(12345, 67890);

Defined in

clients/core/useridentities.d.ts:84

---

setSideLoad

▸ setSideLoad(array): void

Parameters

Name	Type
array	any

Returns

void

Inherited from

Client.setSideLoad

Defined in

clients/client.d.ts:113

---

show

▸ show(userId, userIdentityId): Promise<object>

Show a specific identity for a given user.

Parameters

Name	Type	Description
userId	number	The ID of the user.
userIdentityId	number	The ID of the user identity to show.

Returns

Promise<object>

The user identity details.

Async

Throws

Throws an error if the request fails.

See

https://developer.zendesk.com/api-reference/ticketing/users/user_identities/#show-identity

Example

const identity = await client.useridentities.show(12345, 67890);

Defined in

clients/core/useridentities.d.ts:28

---

update

▸ update(userId, userIdentityId, identity): Promise<object>

Update a specific identity for a given user.

Parameters

Name	Type	Description
userId	number	The ID of the user.
userIdentityId	number	The ID of the user identity to update.
identity	object	The updated identity details.

Returns

Promise<object>

The updated user identity.

Async

Throws

Throws an error if the request fails.

See

https://developer.zendesk.com/api-reference/ticketing/users/user_identities/#update-identity

Example

const updatedIdentity = await client.useridentities.update(12345, 67890, {verified: true});

Defined in

clients/core/useridentities.d.ts:51

---

verify

▸ verify(userId, userIdentityId): Promise<object>

Verify a specific identity for a given user.

Parameters

Name	Type	Description
userId	number	The ID of the user.
userIdentityId	number	The ID of the user identity to verify.

Returns

Promise<object>

The verified user identity.

Async

Throws

Throws an error if the request fails.

See

https://developer.zendesk.com/api-reference/ticketing/users/user_identities/#verify-identity

Example

await client.useridentities.verify(12345, 67890);

Defined in

clients/core/useridentities.d.ts:73