kythene.v1.KytheneService

SetSharePin

SetSharePin sets, changes or (with an empty pin) clears a share code's second-factor PIN, WITHOUT changing the code - so rotating the PIN never invalidates the link already sent. A wrong-PIN lockout is reset.

post/kythene.v1.KytheneService/SetSharePin

Request

  • Base URL: https://kythene.com (the document declares no server; this is the origin it was published from)
  • URL: https://kythene.com/kythene.v1.KytheneService/SetSharePin
  • Auth: none required

Headers

Connect-Protocol-Version1 required

Define the version of the Connect protocol

Connect-Timeout-Msnumber

Define the timeout, in ms

Request body

idstring

id is the share code to set the PIN on (from list_share_codes).

pinstring

pin is the second-factor PIN to require: 4-8 digits, not an obvious sequence. An EMPTY pin CLEARS it. Never returned. The code (link) is unchanged.

spacestring

space optionally selects which of your spaces to act in (an id or name from list_spaces). Omit it when you belong to a single space.

Response

Success

KytheneV1SetSharePinResponse required

Changes

No recorded changes to this operation across all 1 revision of this API.