auth
oauth

Poll a device-authorization login

Long-poll the status of a device login request. Returns the minted JWT once the user approves, or a terminal state (cancelled/expired). Holds the connection up to ~25s while pending.

post/auth/oauth/device/status

Request

  • Base URL: https://api.namefi.io/v-next
  • URL: https://api.namefi.io/v-next/auth/oauth/device/status
  • Auth: one of:
    • API key in header x-api-key
    • HTTP bearer

Headers

x-namefi-eip7702-accountstring

Optional delegated account address to authenticate as when the signer is an approved signer. Preferred header name.

x-namefi-eip1271-accountstring

Legacy alias for x-namefi-erc1271-account. When multiple delegated account headers are present, x-namefi-eip7702-account takes precedence, then x-namefi-erc1271-account.

x-namefi-erc1271-accountstring

Optional delegated account address to authenticate as when the signer is an approved signer. Preferred ERC-1271 header name.

Request body

authReqTokenstring uuid required

The authReqToken returned by the start endpoint.

codeVerifierstring required

PKCE code verifier proving possession of the codeChallenge sent at start.

Response

OK

OR
OR
OR

Changes

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