Auth

Initiate handoff

Changed on

Start a handoff session to transfer authentication between devices. Returns a handoff code for device linking. A desktop app that registers a return deep link can be signed in without the user typing the code.

post/auth/handoff/initiate

Request

  • Base URL: https://web.fluxer.app/api/v1
  • URL: https://web.fluxer.app/api/v1/auth/handoff/initiate
  • Auth: none required

Request body

return_uristring

Deep link the approving browser opens to return the sign-in to the initiating desktop app

Response

Success

codestring required

Handoff code to share with the receiving device

expires_atstring date-time required

ISO 8601 timestamp when the handoff code expires

poll_secretstring

Secret the initiating device must present to retrieve the token

return_method'deep_link' | 'code'

Changes

  • 07d8e2f215e1Revision changes
    • info

      added optional request body

    • info

      added the optional property to the response with the status

  • dd0ad4ea1c88Revision changes
    • info

      the response's property pattern was changed from ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$ to ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z))$ for the status