Skip to content

Interface: IdentitiesApi ​

The methods of Talkline.identities.

Methods ​

get() ​

ts
get(identity): Promise<IdentitySettings>;

GET /v1/identities/{identity}.

Parameters ​

ParameterType
identitystring

Returns ​

Promise<IdentitySettings>


iterateDevices() ​

ts
iterateDevices(identity, query?): AsyncIterable<Device>;

GET /v1/identities/{identity}/devices, every page in turn.

Parameters ​

ParameterType
identitystring
query?Pageless<PageQuery>

Returns ​

AsyncIterable<Device>


listDevices() ​

ts
listDevices(identity, query?): Promise<Page<Device>>;

GET /v1/identities/{identity}/devices, one page.

Parameters ​

ParameterType
identitystring
query?PageQuery

Returns ​

Promise<Page<Device>>


removeDevice() ​

ts
removeDevice(identity, deviceId): Promise<void>;

DELETE /v1/identities/{identity}/devices/{deviceId}.

Parameters ​

ParameterType
identitystring
deviceIdstring

Returns ​

Promise<void>


upsert() ​

ts
upsert(identity, body): Promise<IdentitySettings>;

PUT /v1/identities/{identity}: the whole record; a field it leaves out returns to its default.

Parameters ​

ParameterType
identitystring
bodyUpsertIdentityRequest

Returns ​

Promise<IdentitySettings>


upsertDevice() ​

ts
upsertDevice(
   identity, 
   deviceId, 
   body
): Promise<Device>;

PUT /v1/identities/{identity}/devices/{deviceId}: the whole registration; a field left out is cleared.

Parameters ​

ParameterType
identitystring
deviceIdstring
bodyUpsertDeviceRequest

Returns ​

Promise<Device>

Talkline documentation