assessments

Create Assessment

Save an assessment. Unwraps nested payload if frontend sent {responses:{...}, score:{...}}.

RBAC note (Tier 4, 7 Aug 2026): business_id is resolved via get_active_business_id_optional -- for a normal single-user account this is just current_user.id, unchanged. For an invited teammate, it resolves to the BUSINESS OWNER's id, so the assessment is correctly attributed to the shared business. owner_user (may differ from current_user) is used wherever plan/company_name/activated_at need to reflect the business. The notification email still goes to current_user (whoever actually submitted it), not the owner.

post/assessments

Request

  • Base URL: https://api.openproof.io (the document declares no server; this is the origin it was published from)
  • URL: https://api.openproof.io/assessments
  • Auth: HTTP bearer

Request body

responsesobject required
scoreobject nullable
company_namestring nullable
emailstring nullable

Response

Successful Response

idstring required
report_refstring required
responsesobject required
scoresobject nullable
fix_listobject[] nullable
overallinteger nullable
bandstring nullable
fixed_countinteger nullable
completed_atstring date-time nullable
created_atstring date-time required
version_stampstring required
company_namestring nullable
plan_limit_warningstring nullable

Changes

No recorded changes to this operation across all 1 revision of this API.