Organizations

Record the browser device the caller is signed in from

Records a Fingerprint visitor id against an existing org. It exists because the dominant signup funnel is the first-login auto-onboard, which creates the org server-side with no request body to carry the device on, so without this endpoint the primary funnel would stay dark. Any member of the org may call it. It never changes access, billing, or org state, and it always returns 204 once authorized, including when the body is empty: a browser that blocked the agent must not see an error.

post/v1/orgs/{orgId}/device

Path parameters

orgIdstring required

Request body

captchaActionstring

The reCAPTCHA action the token was minted for (signup_password, signup_magic_link, signup_oauth, deposit, card_save). Already checked against siteverify's own action, which is what stops a token minted on the signup widget being replayed at the deposit endpoint.

captchaBandstring

Which threshold band the score fell in: "pass" (>= 0.7), "step_up" (0.3 to 0.7), or "step_up_strict" (< 0.3). The step-up the band demanded has ALREADY been satisfied by the time the request arrives, so this records how much friction the customer met; it is never an instruction. A deployment with the feature off sends no captcha fields at all rather than a band meaning "we did not look" (docs/architecture/signup-bot-defense.md).

captchaScorenumber

reCAPTCHA v3 score for the action behind this request, 0 to 1 ("1.0 is very likely a good interaction, 0.0 is very likely a bot", https://developers.google.com/recaptcha/docs/v3). The dashboard's server layer obtained it from Google's siteverify and checked the action, hostname, and challenge age before sending it, so this is a VERDICT the control plane records rather than a token it re-verifies. Absent when the feature is off or nothing could be measured, and an absent score is not a zero.

deviceEventIdstring

Fingerprint event id for this identification. It is the half the server verifies with Fingerprint (the visitor id alone cannot be), so a visitor id sent without it is recorded but never clustered.

deviceFingerprintstring

Fingerprint visitor id, the stable per-device identifier.

Response

Recorded, or ignored when the body carried no device

Changes

Changed in 2 of the 36 revisions of this API.4

    • ○

      added the new optional request property

      new-optional-request-property

    • ○

      added the new optional request property

      new-optional-request-property

    • ○

      added the new optional request property

      new-optional-request-property

    • ○

      endpoint added

      endpoint-added