# Clarification on New API Spec Endpoint

**URL:** <https://community.hubspot.com/t/clarification-on-new-api-spec-endpoint/142706>\
**Category:** CRM\
**Tags:** crm\
**Created:** [November 17, 2025, 10:37am UTC](https://community.hubspot.com/t/clarification-on-new-api-spec-endpoint/142706 "2025-11-17T10:37:14Z")\
**Posts on this page:** 3\
**Page:** 1

<div class="post-metadata">

**Author:** ![ShubhangiPawar](https://avatars.discourse-cdn.com/v4/letter/s/9dc877/32.png) [@ShubhangiPawar](https://community.hubspot.com/u/ShubhangiPawar)\
**Post date:** [November 17, 2025, 10:37am UTC](https://community.hubspot.com/t/clarification-on-new-api-spec-endpoint/142706/1 "2025-11-17T10:37:14Z")

</div>

[https://api.hubapi.com/api-catalog-public/v1/apis/crm/v3/objects](https://api.hubapi.com/api-catalog-public/v1/apis/crm/v3/objects)  
has been replaced with the new endpoint:  
[https://api.hubapi.com/public/api/spec/v1/specs](https://api.hubapi.com/public/api/spec/v1/specs).

From our observation, the new endpoint returns a response like:  
[https://api.hubapi.com/public/api/spec/v1/specs/CRM/Objects/versions/424](https://api.hubapi.com/public/api/spec/v1/specs/CRM/Objects/versions/424),  
which seems to provide the same result as the previous CRM Objects spec URL.

Could you please confirm our understanding:

Is the new endpoint designed as a generic/top-level API catalog, and CRM Objects is now part of that hierarchy?  
What does versions/424 represent? Will this version ID change in the future?

---

<div class="post-metadata">

**Author:** ![ShubhangiPawar](https://avatars.discourse-cdn.com/v4/letter/s/9dc877/32.png) [@ShubhangiPawar](https://community.hubspot.com/u/ShubhangiPawar)\
**Post date:** [November 17, 2025, 11:22am UTC](https://community.hubspot.com/t/clarification-on-new-api-spec-endpoint/142706/2 "2025-11-17T11:22:37Z")

</div>

Based on which flag, the openApi link value will be picked incase of multiple specs versions?  
Which flag is consistent across specs and will keep working when HubSpot revs their OpenAPI definitions again?

---

<div class="post-metadata">

**Author:** ![STierney](https://d10pqhm3lwygmk.cloudfront.net/user_avatar/community.hubspot.com/stierney/32/186066_2.png) [@STierney](https://community.hubspot.com/u/STierney)\
**Post date:** [November 17, 2025, 7:55pm UTC](https://community.hubspot.com/t/clarification-on-new-api-spec-endpoint/142706/3 "2025-11-17T19:55:46Z")

</div>

Hey @ShubhangiPawar - thanks for following up here!  
Re-tagging [@moid-space](https://community.hubspot.com/t5/user/viewprofilepage/user-id/1013278) to see if we can get any additional context for you!  
Shane, Senior Community Moderator