# info.summary
Public onboarding API used by the Photon website funnel.

# info.description
Create or resume an onboarding session, save path-specific onboarding answers, and submit a completed onboarding flow. The companion onboarding schema endpoint returns the current path definitions, steps, and fields.

# tags[].description
First-party onboarding endpoints for prescriber, developer, clinic, enterprise, platform, and other paths.

# tags[].description
Machine-readable discovery resources for agents and integrations.

# paths./api/onboarding/schema.get.description
Returns every onboarding path in `allPaths`, plus the active path-specific step list when the optional `path` query parameter is supplied.

# paths./api/onboarding/schema.get.parameters[].description
Optional onboarding path id used to return the currently active step list.

# paths./api/onboarding/schema.get.responses.200.content.application/json.example.data.allPaths[].steps[].fields[].placeholder
Tell us about your patient population and what you typically prescribe.

# paths./api/onboarding/schema.get.responses.200.content.application/json.example.data.allPaths[].steps[].fields[].placeholder
Describe your ideal prescribing workflow

# paths./api/onboarding/schema.get.responses.200.content.application/json.example.data.allPaths[].steps[].fields[].placeholder
Urgent care, pediatrics, weight loss, etc.

# paths./api/onboarding/schema.get.responses.200.content.application/json.example.data.allPaths[].steps[].fields[].placeholder
Tell us how we can support your clinicians and patients

# paths./api/onboarding/schema.get.responses.200.content.application/json.example.data.allPaths[].steps[].fields[].placeholder
Describe your use case and any opportunities

# paths./api/onboarding/schema.get.responses.200.content.application/json.example.data.allPaths[].steps[].fields[].placeholder
EHR, clinical workflow tool, care delivery platform

# paths./api/onboarding/schema.get.responses.200.content.application/json.example.data.allPaths[].steps[].fields[].placeholder
Describe the experience you want to enable

# paths./api/onboarding/sessions.post.description
Creates a local-only session until valid contact details identify the lead. A prior lead token may be supplied in the `x-onboarding-lead-token` header, cookie, or request body.

# paths./api/onboarding/sessions.post.requestBody.content.application/json.schema.properties.flowId.description
Browser-local flow id used before the server issues a session id.

# paths./api/onboarding/sessions.post.requestBody.content.application/json.schema.properties.leadToken.description
Optional serialized lead token. Prefer the `x-onboarding-lead-token` header when available.

# paths./api/onboarding/sessions/{sessionId}.patch.description
Persists step answers and, when advancing from contact details with a valid email, identifies the lead and syncs the Attio list item.

# paths./api/onboarding/sessions/{sessionId}/submit.post.description
Validates all required path fields, marks the onboarding session submitted, syncs Attio, and runs provisioning when that path is configured.

# paths./api/onboarding/sessions/{sessionId}/submit.post.requestBody.content.application/json.example.answers.use_case
Embedded prescribing for a care team workflow.

# paths./api/onboarding/sessions/{sessionId}/submit.post.responses.422.description
Validation failed. The response includes inline field errors and the step that needs attention.

# paths./openapi.json.get.responses.200.description
OpenAPI 3.1 document for Photon onboarding.

# paths./.well-known/openapi.json.get.summary
Get this OpenAPI document from the well-known path

# paths./.well-known/openapi.json.get.responses.200.description
OpenAPI 3.1 document for Photon onboarding.

# paths./.well-known/api-catalog.get.responses.200.description
RFC 9727 linkset pointing to OpenAPI, docs, schema, and llms.txt.

# components.schemas.OnboardingPathId.description
Public onboarding path id. `/onboard#{id}` starts the human funnel at that path.

# components.schemas.Answers.example.use_case
Tell us about your patient population and what you typically prescribe.

# components.schemas.Answers.example.care_model
Urgent care, pediatrics, weight loss, etc.

# components.schemas.Answers.example.product_category
EHR, clinical workflow tool, care delivery platform

# components.schemas.SaveStepRequest.properties.turnstileToken.description
Cloudflare Turnstile token. Required when both Turnstile keys are configured and the request identifies a lead.

# components.schemas.SubmitRequest.properties.turnstileToken.description
Cloudflare Turnstile token. Required when both Turnstile keys are configured.