Create a parent-invite challenge
Creates a parent-invite challenge bound to `sessionId` and sends the invite email to `parentEmail`. Available only for players who don't require parental consent and whose session isn't already linked to a parent; other sessions are rejected (see the error codes below). On PASS, `Challenge.StateChange` fires carrying the same `sessionId`, so you can correlate the result with this invite.
Authorization
api-key In: header
Request Body
application/json
Invite parent request
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
curl -X POST "https://example.com/challenge/invite-parent" \ -H "Content-Type: application/json" \ -d '{ "sessionId": "b1a6482d-5242-4b4a-aa88-3fa52595a672", "parentEmail": "parent@example.com", "playerName": "Alex", "locale": "en" }'{ "status": "CHALLENGE", "challenge": { "challengeId": "ae6d4729-af32-42ea-8ef2-ff46c7664802", "type": "CHALLENGE_PARENT_INVITE" }}{ "error": "INVALID_INPUT", "errorMessage": "The request was missing a sessionId parameter."}Get challenge GET
Returns a previously created challenge. The `oneTimePassword` and `url` are omitted once the challenge has passed or failed, so capture them while the challenge is still open if you need to re-present it.
Send email with payment verification POST
Emails a parental consent request to a guardian together with your attestation that an adult already completed a payment for the purchase behind it. Identical to `/challenge/send-email` except that `paymentVerification` is required. Use that endpoint instead when there is no payment to attest. The attestation is read only when the Transactions capability is enabled for your organization, and is otherwise ignored.