Generate manage session permissions URL
Returns a URL for the hosted manage-permissions widget, to display in an iframe. It lets a guardian revisit and change the permissions they previously granted on a session. The `email` must match the guardian who approved that session.
Authorization
api-key In: header
Request Body
application/json
Generate manage permissions URL request
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
curl -X POST "https://example.com/widget/generate-manage-session-permissions-url" \ -H "Content-Type: application/json" \ -d '{ "sessionId": "b1a6482d-5242-4b4a-aa88-3fa52595a672", "email": "parent@example.com" }'{ "url": "https://family.k-id.com/widget", "shortUrl": "https://family.k-id.com/s/12345678-1234-1234-1234-123456789012?pid=42&s=qr"}Generate e2e URL POST
Returns a URL for the hosted end-to-end widget, to display in an iframe. The widget carries a player through the whole flow — age gate, then any consent challenge it triggers — in one hosted experience, so a single embed replaces orchestrating the individual endpoints. Supply whichever age signal you already hold (`kuid`, `age`, or `dateOfBirth`) to skip the widget's own age collection step.
Generate parental consent URL POST
Returns a URL for the hosted parental consent widget, to display in an iframe. Present it to the guardian of an existing challenge to collect their consent. This is the same experience `/challenge/send-email` links to, for cases where you deliver the link yourself.