SHshareout
Auth

Start CLI device login

RFC-8628-style device authorization for CLI/agents. No auth required. Optional expected_email pre-selects the Google account and drives a mismatch warning on approval.

post/v1/auth/device/start

Request

  • Base URL
    https://shareout.site
  • URL
    https://shareout.site/v1/auth/device/start
  • Auth
    none required

Request body

expected_emailstring email

Email the user expects to sign in as (e.g. invite address).

Response

Pending device authorization

device_codestring required

Secret held by the CLI for polling.

user_codestring required

Short code shown in the browser (e.g. XXXX-XXXX).

verification_uristring uri required
verification_uri_completestring uri required
intervalinteger required

Minimum poll interval in seconds.

expires_ininteger required

Seconds until the code expires.

Changes

No recorded changes to this operation across all 22 revisions of this API.