hornet icon

hornet

Interact with hornet API

Actions452

Multi Factor Authentication → Mfa Force Post

AI-generated

Summary

Force multi-factor authentication for a specific customer, optionally enforcing it for administrators and/or regular users.

Inputs

  • object_id (required) — The customer object identifier (must be a customer). Sent as a query parameter.
  • APP-ID (required) — Application identifier issued by Hornet Security. Sent in the request header.
  • force_for_admins — When true, MFA is forced for administrator accounts. Defaults to true. Sent in the request body as a boolean.
  • force_for_users — When true, MFA is forced for regular user accounts. Defaults to true. Sent in the request body as a boolean.

Output shape

JSON response from the Hornet API indicating the result of the MFA force operation.

The exact structure depends on the API but typically includes a success flag and any error messages.

Examples

Example 1: Force MFA for customer 12345 for both admins and regular users

Set object_id=12345, APP-ID=, keep force_for_admins and force_for_users at their defaults (true).

Example 2: Force MFA only for regular users, not admins

Set object_id=12345, APP-ID=, force_for_admins=false, force_for_users=true.

Links

Discussion