Generate a new OTP for the challenge
This API is used to generate a new one-time password (OTP) for a given challenge.
Authorization
api-key In: header
Header Parameters
Optional header for Account System Products to perform cross-product age gate checks. The value must be the product ID of the target product within the same organization. The target product must not itself be an Account System Product.
Request Body
application/json
Set challenge status request
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
curl -X POST "https://example.com/challenge/generate-otp" \ -H "Content-Type: application/json" \ -d '{ "challengeId": "b1a6482d-5242-4b4a-aa88-3fa52595a672" }'{ "otp": "123ABC", "expiresAt": "2022-12-31T23:59:59Z", "url": "https://example.com/challenge"}{ "error": "NOT_FOUND", "errorMessage": "Challenge not found"}Create bulk challenges POST
Creates parental consent challenges for several products at once, for a single player, so one guardian interaction can cover a whole product family. The response carries a challenge per requested product. As with a single challenge, `oneTimePassword` and `url` are omitted once a challenge has passed or failed.
Get challenge status GET
Returns the outcome of a challenge, and is the endpoint to poll while waiting for a guardian to act. Call it after `/age-gate/check` returns `CHALLENGE`. Once it reports `PASS`, follow with `/session/get` to read the now-`ACTIVE` session and the permissions it grants. `FAIL` means the challenge is settled and will not progress.