Organizations

Transition an administrator MFA approval using revision CAS

post/organizations/{organizationId}/admin-mfa-approval/approvals/{approvalId}/approve

Request

  • Base URL: https://api.xfa.tech
  • URL: https://api.xfa.tech/organizations/{organizationId}/admin-mfa-approval/approvals/{approvalId}/approve
  • Auth: HTTP bearer

Path parameters

organizationIdstring required
approvalIdstring required

Request body

expected_revisioninteger required
reasonstring

Response

Updated approval

requester_emailstring email

Verified sign-in email of the applicant. Omitted when not yet recorded; never inferred from the device owner.

approval_idstring required
canonical_user_idstring required
device_idstring required
status'PENDING' | 'APPROVED' | 'REJECTED' required
revisioninteger required
requested_atstring date-time
updated_atstring date-time required

Last change, including a sign-in that refreshes the request context.

decided_atstring date-time

When an admin (or turning approval off) last decided; absent while never decided.

rejection_reasonstring

The reason of the latest rejection, only for REJECTED approvals. It is the text the user sees on sign-in; who decided stays out of the list.

resolution_source'MANAGED_DEVICE' | 'ADMIN' | 'POLICY_OFF'

What resolved the approval: automatic approval of a managed device, an administrator, or turning approval off. Absent while never decided.

setting_versioninteger required
grandfatheredboolean required
created_atstring date-time required

Changes

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