First-time day at Headway

Restore note attachments when refreshed sessions fail

Published Oct 22, 2026

You’re the security / reliability engineer. Your team is in the room.

The setting

is a marketplace and software platform that connects patients, health insurers and independent providers of mental health care across the United States. is the software therapists and psychiatric prescribers use to accept insurance and run their practice.

Refreshed sessions are failing at the boundary between reliable access and least privilege.

Clinicians need records during care, while the authorization path must continue to prevent access beyond their own patients.

Who you’d be doing this for

“My next client was waiting while I signed out twice just to open the worksheet from their last session.”

Lotanna Quaye · Licensed Clinical Social Worker · a character in this brief

A solo clinician who opens session documentation and attachments between appointments.

What is at stake

Valid clinician attachment requests are failing after a session refresh, interrupting access to session materials. You have to restore the flow without weakening the boundary around patient records.

Why it isn’t already fixed

Every obvious fix costs something else. That’s the part you’d have to decide.

  • clinician continuity vs. least-privilege enforcement
  • narrow recovery vs. shared-platform change
  • fast restoration vs. authorization review

Why Headway

Clinical documentation is part of the daily practice workflow for independent mental health clinicians using the platform.

Written with these in mind

security-focused SREproduct security engineerplatform reliability engineer

Not your kind of problem? 104 more at Headway, or browse every organization.

Where the organization context comes fromThe postings this brief was written from, and the reporting read before it.

The organization context comes from public information. The situation and characters are written for the brief.

Job postings it was written from

Public descriptions of the work at Headway. They are listed as sources, not as openings. The lines under a posting are its own words, where it meets this brief.

  • Senior Security Engineer (Infrastructure) (opens in a new tab)
  • Staff Infrastructure Engineer · no longer posted
    • Build the Terraform self-serve platform with guardrails so engineering teams own their standard infrastructure changes and Reliability Engineering reviews only the non-standard ones.
  • Senior Security Engineer (Product) · no longer posted
    • Headway’s mission is a big one – to build a new mental health care system everyone can access.
    • Since then, we’ve grown into a diverse, national network of over 60,000 mental healthcare providers across all 50 states who run their practice on our software and have served over 1 million patients.
  • Senior Software Engineer (Trust Foundations) · no longer posted
    • Building for trust is non‑negotiable in our mission of making mental healthcare more accessible and affordable across the US: patients share sensitive information, payers demand demonstrably strong controls, and providers depend on reliable, secure infrastructure.
    • Scale our identity rails - Design and evolve multi‑tenant authentication & authorization services that handle millions of sessions daily with high availability expectations.

This is the setup. The work is inside.

Running it puts you in the room: the full situation and its constraints, stakeholders who push back in their own words, and the decisions that are yours to make. What you produce becomes a Day One Plan — work you can show someone instead of describing.

Other live briefs connected to this one, and what connects them.

Similar problems at other organizations

Like this one, each of these is about people starting something and never quite finishing it.

The same setting, from another role

Each is set around Headway’s Headway for Providers, written for a different role. They’re separate briefs, not the same scenario.

Other problems with a similar purpose

In each of these, as in this one, the aim is to remove a real security exposure while keeping the everyday workflow people depend on running smoothly.