Authentication

Create step-up auth challenge

Creates a cryptographic challenge bound to a specific action (e.g. approving a high-risk transaction). The device signs the challenge nonce to prove possession of the private key.

post/v1/auth/devices/{device_id}/challenge

Request

  • Base URL: https://api.1claw.co
  • URL: https://api.1claw.co/v1/auth/devices/{device_id}/challenge
  • Auth: HTTP bearer

Path parameters

device_idstring uuid required

Request body

actionstring required

The action this challenge authorizes (e.g. "approve_transaction")

target_idstring required

ID of the resource the action targets

Response

Challenge created

challenge_noncestring required
expires_atstring date-time required
action_bound_hashstring required

SHA-256 binding the challenge to the requested action and target

Changes

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