Security & data handling

Phosra handles children's data, so the bar is higher than "we take security seriously." This page is the developer-facing reference: exactly which fields each object stores, how long they live, how to erase them against a real endpoint you can call right now, how data is encrypted, where it lives, who the subprocessors are, and how to report a vulnerability.

One source of truth. The authoritative, always-current security posture — subprocessor list, DPA, SOC 2 status, incident history — lives at the Phosra Trust Center. This page mirrors it for developers and adds the runnable erasure flow. Where a claim is forward-looking rather than code-verifiable today, it is tagged policy preview.

Data minimization — collect the least that works

Phosra is a control plane for parental-controls policy, not a data lake. It stores the metadata needed to compile and enforce a policy, and nothing it does not need. The core object model is the whole surface — there is no hidden telemetry object.

What each object stores

FieldClassificationWhy it's collected
idIdentifierPrimary key.
nameLow-sensitivityHousehold display name (e.g. "The Rivera Family"). Free-text — not validated as a legal name.
created_at / updated_atMetadataLifecycle timestamps.

No address, no payment data, no location. A family is a container.

What Phosra never does with child data

No sale or brokering

Minor data is never sold, rented, or brokered — ever.

No ad targeting

Child data is never used for advertising or ad targeting, and never shared with ad networks or data brokers.

No external model training

Child data is never used to train external ML models.

No content logging

Phosra enforces against categories. It does not keep a log of a child's messages, browsing, or activity.

Retention

Data classDefault retentionConfigurable?
Child profile + policy stateLife of the account; erased on parent-initiated deletion (below).Yes — parent-initiated erasure at any time.
Enforcement + audit logsRetained only as long as required for regulatory defensibility.policy preview
BackupsPurged on the standard backup-rotation cycle after a live-store delete.policy preview

Retention windows are parent-configurable, and defaults follow the most conservative applicable statute (COPPA / UK AADC). The exact numeric windows and the backup-rotation period are governed by the DPA rather than the API — request them from [email protected] for a security review. They are tagged policy preview here because they are not readable from the sandbox or OpenAPI spec.

Right to erasure — a real, runnable flow

Erasure is not a support ticket. Deleting a Family cascades to every Child, ChildPolicy, PolicyRule, and enforcement record beneath it, and deleting a single Child erases just that child's subtree. Both are ordinary DELETE calls that return 204 No Content.

Every request and response below was captured live against the public sandbox https://phosra-api-sandbox-production.up.railway.app on 2026-07-06 — so you can run this end-to-end right now. In production these routes require a WorkOS session JWT for the signed-in parent and an owner/parent role on the family — they are consumer routes, so a phosra_ developer key does not authenticate them. See Authentication and Environments.

Erase a single child

DELETE /children/{childID} removes the child profile and its entire policy subtree.

bash
# childID from when you created the child (or POST /setup/quick)
curl -i -X DELETE "$PHOSRA_BASE_URL/children/e6e094ee-de89-4dc2-98b2-cd3c3a28309e"
# → HTTP/2 204

Verify it's gone — a read of the erased child returns 404, not a soft-deleted tombstone:

bash
curl -s "$PHOSRA_BASE_URL/children/e6e094ee-de89-4dc2-98b2-cd3c3a28309e"
# → 404  {"error":"Not Found","message":"child not found","code":404}

Erase the whole household (cascade)

DELETE /families/{familyID} erases the family and everything beneath it in one call — proven live: a child created under the family reads 404 immediately after the family delete.

bash
curl -i -X DELETE "$PHOSRA_BASE_URL/families/ec5bc0d7-e02c-42f8-b821-c71d926f27d2"
# → HTTP/2 204
 
# The child that lived under it is now gone too:
curl -s -o /dev/null -w "%{http_code}\n" \
  "$PHOSRA_BASE_URL/children/d48d0260-1881-449e-98f8-7aa21dae546c"
# → 404

Removing one guardian, not the household: to detach a single parent/guardian without erasing anyone's data, use DELETE /families/{familyID}/members/{memberID} (also 204). That removes the person's access; it does not delete the children.

Data portability / export

Machine-readable JSON exports for portability (GDPR Art. 20 / CCPA) are available on request — email [email protected]. There is no self-serve export endpoint on the API today (a GET …/export returns 404) — we say so plainly rather than imply one exists. A self-serve export API is policy preview.

Encryption

In transit — TLS 1.3 + HSTS

HTTPS is enforced end-to-end with TLS 1.3; HSTS at the edge. A conservative Content-Security-Policy restricts script, frame, form, base, object, and worker sources. Plain-HTTP requests are redirected, never served.

At rest — AES-256-GCM

Postgres with tenant scoping enforced at the application layer on every query. AES-256-GCM is applied to sensitive fields (OAuth tokens, provider credentials) on top of standard at-rest disk encryption.

Sealed data-plane envelope

OCSS signals are sealed end-to-end to the recipient's key. The routing layer reads only the headers it needs to move a signal — the router structurally cannot decrypt the payload. See Content monitoring.

Short-lived auth

Production auth runs on WorkOS with short-lived JWTs and a separate sandbox tenant for development. Admin actions are gated behind explicit role checks on every request.

Data residency & subprocessors

US-primary data residency across all subprocessors. Phosra updates this list when the data path changes; the Trust Center is the authoritative copy.

SubprocessorPurposeRegion
SupabasePostgres database + object storageUS
RailwayAPI compute (phosra-api)US
VercelEdge CDN + Next.js hostingGlobal edge, US origin
WorkOSAuthentication (JWT / AuthKit)US
SentryError tracking + performance monitoringUS
ResendTransactional emailUS

Need the signed subprocessor DPA for your vendor review? Request it at [email protected].

Regulatory alignment

Phosra maps its controls to the statutes that govern children's data. Conformance is evidence a regulator can weigh — not an approval Phosra issues, and not a safe harbor.

FrameworkHow Phosra aligns
COPPA / COPPA 2.0Verifiable parental consent, minimum-necessary collection, and parent-initiated deletion are built into the enforcement engine.
GDPR-K / GDPR (Art. 8 child consent, Art. 17 erasure, Art. 33 breach notice)Erasure is a live DELETE (above); breach notification within 72 hours; data-minimized child object.
UK AADC (Age-Appropriate Design Code)High-privacy defaults, no profiling, no nudges — enforceable policies in the registry, not documentation wishes.
KOSADuty-of-care surfaces mapped across the OCSS rule categories.
EU DSA (Art. 28)Minor-protection obligations supported via queryable audit trails and transparency-report-ready exports.
CCPA / CPRANo sale/share of minor data; deletion and portability honored.

See the compliance hub for the per-statute detail pages.

Report a vulnerability

Phosra welcomes good-faith security research.

  1. 1

    Send findings to [email protected]. We triage within one business day and keep you updated through remediation.

  2. 2
    Stay in scope

    Don't access data that isn't your own, don't test against production parent or child accounts, and don't run scanners that degrade service. Use the open sandbox for testing — it holds only synthetic data.

  3. 3
    Coordinated disclosure

    Give us a reasonable window to remediate before public disclosure. With your permission, we credit researchers in our disclosure log.

Incident response. On a confirmed incident Phosra follows a documented playbook — contain, assess, notify, remediate — with breach notification within 72 hours of confirmation, consistent with GDPR Article 33 and CCPA. Affected parents are contacted directly via the email of record.

Where to go next