Poll whether a challenge was answered

GET

/mfa/attempts/{attempt}/confirmed

const url = 'https://work.optidata.cloud/api/mfa/attempts/example/confirmed';
const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request GET \
  --url https://work.optidata.cloud/api/mfa/attempts/example/confirmed \
  --header 'Authorization: Bearer <token>'

Cheap poll used by the screen that is waiting for the user to confirm on their device.

Authorizations

bearerAuth

Parameters

Path Parameters

attempt

required

string

Public identifier of the challenge.

Responses

200

Whether the challenge has been confirmed.

application/json

object

confirmed

required

boolean

Examples

waiting

{
  "confirmed": false
}

401

Missing, malformed or expired authentication key.

application/json

Authentication failures use an error key rather than message.

object

error

required

string

Examples

missing

No bearer token sent

{
  "error": "JWT passport exception: Missing bearer token in request"
}

404

The resource does not exist, or does not belong to the given drive.

application/json

Generic error envelope used by policy, binding and framework failures.

object

message

required

Human-readable description of the failure.

string

Examples

missing

{
  "message": "No query results for model [App\\Models\\Node] 99999999"
}

429

Rate limit exceeded. Retry after the window resets.

application/json

Generic error envelope used by policy, binding and framework failures.

object

message

required

Human-readable description of the failure.

string

Examples

throttled

{
  "message": "Too Many Attempts."
}