For Vendors: Submit Product Data
Full Stack HVAC builds its product catalog editorially from public sources. If you make an HVAC product, tool, training program, or service, you can supply structured data (or correct what we already have) through a machine-readable submission contract. Point your AI agent at the manifest, fill the schema, and submit.
What this is, and is not. Submissions are structured factual claims for editorial verification, reviewed against manufacturer materials and other authoritative public sources. They are not published verbatim. Submitting is not a path to a better score or placement: a submission never directly changes FSH Scores, rankings, or editorial conclusions. Only independently verified factual corrections may update a product record, and any resulting score change follows from our published methodology. Classification you suggest is a hint; editorial assignment is authoritative. This channel is optional and free. See our Vendor Relations policy.
How it works
- Point your AI agent (Claude, Codex, or similar) at the discovery pointer: https://fullstackhvac.com/.well-known/fsh-product-submission.json. It links to the manifest, schema, starter, examples, and catalogs.
- Read the JSON Schema to learn the field contract. It embeds an
x-fsh-instructionsblock with the rules and policy. - Pick the example matching your product kind, and use the starter for a blank skeleton.
- Choose classification and feature slugs from the published catalogs. If nothing fits, omit it or use the free-text fallback, and editorial maps it.
- Fill the envelope (one vendor, one or more products). Leave out anything you cannot verify; an omitted field means "unknown", which is treated differently from an explicit "false".
- Validate against the schema, then POST it to the endpoint (or paste it into the form below).
The contract
- Discovery pointer: https://fullstackhvac.com/.well-known/fsh-product-submission.json
- Manifest: https://fullstackhvac.com/templates/v1/manifest.json
- JSON Schema (2020-12): https://fullstackhvac.com/templates/v1/submission.schema.json
- Starter skeleton: https://fullstackhvac.com/templates/v1/starter.json
Examples (one per product kind)
software: https://fullstackhvac.com/templates/v1/examples/software.example.jsonphysical_tool: https://fullstackhvac.com/templates/v1/examples/physical-tool.example.jsontraining: https://fullstackhvac.com/templates/v1/examples/training.example.jsonmentorship: https://fullstackhvac.com/templates/v1/examples/mentorship.example.jsonservice: https://fullstackhvac.com/templates/v1/examples/service.example.json
Catalogs (allowed values)
Submit
Agents should POST the completed JSON (Content-Type: application/json) to
/api/v1/product-submissions. You will receive a submission id. Without an agent,
paste a completed, schema-valid submission below.
By submitting you confirm that you are authorized to submit this information on the vendor's behalf; that any asset URLs, logos, and trademarks you provide are owned by the vendor or licensed for Full Stack HVAC to use and display for catalog and editorial purposes; that the data is accurate to the best of your knowledge and contains no confidential or NDA-restricted information; and that you understand the data is verified editorially and does not affect scores. Questions: editorial@fullstackhvac.com.
We use the contact details in your submission, plus technical metadata such as IP address and user agent, to process, verify, and prevent abuse of submissions. See our Privacy Policy.