Skip to main content

Request a screentime override

POST 
/screentime/request-override

Submits an override request on the kid's behalf when they want more time today or to bypass active quiet hours. k-ID records the request and notifies the parent to approve or deny. Idempotent per kid: a call made while another request from the same kid is still pending returns that pending request unchanged rather than creating a second one.

The resolution arrives asynchronously as a single Screentime.OverrideResult webhook with status: "granted" | "denied" | "expired". The webhook body carries the same shape as GET /screentime/get-state under state, so the platform can update its copy of the state directly without a follow-up fetch. Requests that aren't resolved within 24 hours fire the webhook with status: "expired".

Request​

Responses​

Override request accepted.