Start Push Challenge
Start a push challenge by sending a notification to the user’s mobile device.
Authorizations
Use a short-lived token obtained from the Server API's Track Action endpoint. The token is valid for 10 minutes and should be passed in the Authorization header as 'Bearer {token}'.
Body
The action code used to identify the challenge in the Authsignal Portal.
The ID of a specific enrolled push authenticator to target. When provided, the challenge is sent only to that authenticator and can only be approved from that device. When omitted, the challenge is sent to all of the user's eligible push authenticators.
Response
OK
The ID of the challenge which has been initiated. Use this ID to lookup whether the challenge has been approved or rejected by the user on their mobile device (e.g. via polling).
The outcome of sending the notification to each of the user's targeted push authenticators. Only returned when the tenant sends push notifications via APNs or FCM directly. Push delivery is best-effort: a failed send does not fail the challenge, because the user can still approve it by opening your app. A failed send is also recorded on the authenticator as erroredAt and errorCode, and cleared by the next successful send - see Get Authenticators.

