DealerMAX Developers
Changelog
Public release notes for DealerMAX Developers. This changelog separates Dealer Public API contract changes from portal documentation changes so integrators can decide when to regenerate clients or update runtime handling.
Versioning policy
| Current public contract | Dealer Public API OpenAPI 1.0.0. |
|---|---|
| Stability promise | Additive fields, response schemas, examples, and documentation fixes can ship within 1.x. Breaking wire changes require a new major path such as /v2/. |
| Deprecation window | Breaking changes are announced with Deprecation and Sunset headers and at least 180 days of overlap. |
| Machine-readable feed | https://developers.dealermax.app/changelog.atom |
2026-06-29 - PartnerMAX - SDK docs 1.5.13
Changed
- Aligned the PartnerMAX portal and PDF to the SDK contract tested with the freshly generated Python and TypeScript SDKs.
- Documented
client.dealers.create(...)as the SDK dealer-creation path backed byPOST /api/partner/dealers. - Documented that used-vehicle listing/detail routes are always dealer-scoped and there is no global PartnerMAX stock listing.
- Documented multipart image upload with Python file-like objects and Node
toFile(..., { type: "image/jpeg" }). - Documented ID-based optionals, packages, equipment, authenticated
no-storereads, and the 1.5.13 MIME upload tolerance fix.
2026-06-27 - Portal - DealerMAX MCP Server documentation
Added
- Added https://developers.dealermax.app/mcp as the canonical developer documentation for the public DealerMAX MCP Server.
- Documented namespace
app.dealermax/public-search, registry version1.2.1, endpointhttps://mcp.dealermax.app/mcp/, server card, tool catalog, read-only policy, and REST/API boundary. - Added the MCP Server to
/.well-known/apis.json,/sitemap.xml,/llms.txt, service status, and the machine-readable changelog feed.
Changed
- The Developers overview now presents three distinct public surfaces: Dealer Public API, DealerMAX MCP Server, and PartnerMAX Enterprise.
2026-06-27 - Portal - PartnerMAX trial onboarding
Added
- Added https://developers.dealermax.app/signup for self-service PartnerMAX trial onboarding.
- The flow verifies email by magic link, binds signup to a verified Partita IVA, creates a 15-day live trial, grants 3,000 credits, and shows the first Partner key once.
Changed
- PartnerMAX access starts before Stripe with strict trial limits; Stripe is required to continue after the trial.
2026-06-26 - API contract - Dealer Public API 1.0.0
Added
- OpenAPI response component schemas for inventory listing/details and dealer content hub/search/listing/details.
DealerPublicProblemDetailsschema forapplication/problem+jsonerror responses.- Machine-readable changelog feed at https://developers.dealermax.app/changelog.atom.
Changed
- Dealer Public API errors on
/dealer/*now use stablecodevalues and dereferenceabletypeURLs under https://developers.dealermax.app/errors. - SDK guidance now treats generated clients as typed on both requests and successful responses.
Fixed
- OpenAPI now documents non-200 responses for
400,401,404,422,429,503, and500.
2026-06-25 - Portal - DealerMAX Developers launch
Added
- Rebuilt the public portal around the Dealer Public API as the primary surface.
- Added quickstart, API reference, SDK, security, rate-limit, error catalog, and
.well-known/apis.jsonsurfaces. - Documented backend/BFF-only integration guidance for dealer API keys.
Changed
- Moved PartnerMAX to a separate enterprise section.
- Pruned the error catalog to the read-only Dealer Public API surface.
Contracts
| Dealer Public API | Canonical OpenAPI on apimax |
|---|---|
| DealerMAX MCP Server | Canonical MCP documentation |
| Developer portal | APIs.json index |
| PartnerMAX | Enterprise section |
| Changelog feed | Atom feed |