package org.signal.chat.device

Get desktop application:
View/edit binary Protocol Buffers messages

Provides methods for working with devices attached to a Signal account.

• rpc ClearPushToken (ClearPushTokenRequest, ClearPushTokenResponse)

  device.proto:45

  Removes any push tokens associated with the authenticated device. After calling this method, the server will assume that the authenticated device will periodically poll for new messages.

  message ClearPushTokenRequest

  device.proto:130

  (message has no fields)

  message ClearPushTokenResponse

  device.proto:132

  (message has no fields)

• rpc GetDevices (GetDevicesRequest, GetDevicesResponse)

  device.proto:24

  Returns a list of devices associated with the caller's account.

  message GetDevicesRequest

  device.proto:51

  (message has no fields)

  message GetDevicesResponse

  device.proto:53

  • repeated GetDevicesResponse.LinkedDevice devices = 1

    A list of devices linked to the authenticated account.

• rpc RemoveDevice (RemoveDeviceRequest, RemoveDeviceResponse)

  device.proto:30

  Removes a linked device from the caller's account. Linked devices may only remove themselves. Primary devices may remove any device other than themselves.

  message RemoveDeviceRequest

  device.proto:79

  • uint32 id = 1

    The identifier for the device to remove from the authenticated account. The identifier must not be for the primary device.

  message RemoveDeviceResponse

  device.proto:104

  (message has no fields)

• rpc SetCapabilities (SetCapabilitiesRequest, SetCapabilitiesResponse)

  device.proto:48

  Declares that the authenticated device supports certain features.

  message SetCapabilitiesRequest

  device.proto:134

  • repeated common.DeviceCapability capabilities = 1

  message SetCapabilitiesResponse

  device.proto:138

  (message has no fields)

• rpc SetDeviceName (SetDeviceNameRequest, SetDeviceNameResponse)

  device.proto:36

  Sets the encrypted human-readable name for a specific devices. Primary devices may change the name of any device associated with their account, but linked devices may only change their own name. The response will indicate if the target device was not found.

  message SetDeviceNameRequest

  device.proto:85

  • bytes name = 1

    A sequence of bytes that encodes an encrypted human-readable name for this device.

  • uint32 id = 2

    The identifier for the device for which to set a name.

  message SetDeviceNameResponse

  device.proto:94

  • oneof response

    • google.protobuf.Empty success = 1

      The device name was successfully set

    • errors.NotFound target_device_not_found = 2

      No device with the provided identifier was found on the account

• rpc SetPushToken (SetPushTokenRequest, SetPushTokenResponse)

  device.proto:40

  Sets the token(s) the server should use to send new message notifications to the authenticated device.

  message SetPushTokenRequest

  device.proto:106

  • oneof token_request

    • SetPushTokenRequest.ApnsTokenRequest apns_token_request = 1

      If present, specifies the APNs device token(s) the server will use to send new message notifications to the authenticated device.

    • SetPushTokenRequest.FcmTokenRequest fcm_token_request = 2

      If present, specifies the FCM push token the server will use to send new message notifications to the authenticated device.

  message SetPushTokenResponse

  device.proto:128

  (message has no fields)

Used in: GetDevicesResponse

• uint32 id = 1

  The identifier for the device within an account.

• bytes name = 2

  A sequence of bytes that encodes an encrypted human-readable name for this device.

• uint64 last_seen = 3

  The approximate time, in milliseconds since the epoch, at which this device last connected to the server.

• uint32 registration_id = 4

  The registration ID of the given device.

• bytes created_at_ciphertext = 5

  A sequence of bytes that encodes the time, in milliseconds since the epoch, at which this device was attached to its parent account.

Used in: SetPushTokenRequest

• string apns_token = 1

  A "standard" APNs device token.

Used in: SetPushTokenRequest

• string fcm_token = 1

  An FCM push token.