Skip to main content
POST
Send a sign-in code
When a site sends a code by text or a phone app, the run waits up to 3 minutes. The app shows Enter the code sent to your phone in the run panel; from code, call this. The run types the code and carries on. No code in time: the run fails with needs_user.kind = "otp_sms". A run that is not waiting for a code returns 409. Needs logins:use. See Logins and browser profiles.

Authorizations

Authorization
string
header
required

API key with the vd_sk_ prefix, as Authorization: Bearer vd_sk_.... Create keys in Settings → API Keys.

Headers

Idempotency-Key
string

Any unique string (such as your order id). Resending the same request with the same key within 24 hours returns the first answer (with Idempotent-Replayed: true) and does nothing twice; the same key with a different request is a 422 idempotency_key_reused.

Required string length: 1 - 255

Path Parameters

run_id
string
required

Body

application/json
code
string
required

The sign-in code the site sent.

Required string length: 4 - 20

Response

The run has the code.

run_id
string
required
accepted
boolean
default:true