Skip to Content

MC283912: Yammer Public Links API Changes

Updated March 08, 2021: We have updated this message with additional details for clarity. Thank you for your feedback.

We’re making some changes to public OGOs (Open Graph Objects) over the next two quarters. The effected APIs are:

  • GET api/v1/open_graph_objects?url=https://
  • GET /messages/open_group_objects/:id.json

MC283912: Yammer Public Links API Changes

Affected Workloads

  • Yammer Enterprise

Note: If you have not developed custom integration with Yammer or use 3rd party software which includes specific API calls, you can safely ignore this message.

Key points

  • Timing: March 1, 2022
  • Control type: admin control
  • Action: review and assess

How will this affect your organization?

Phase 1 (November 1st, 2021): No breaking change to GET api/v1/open_graph_objects?url=https://

After November 1st, Microsoft will add a list consisting of a single OGO (which is the same OGO currently being returned by the API) to the response of GET api/v1/open_graph_objects?url=https:// – this is unlikely to affect your usage of this API, but Microsoft still recommends checking how you are consuming the API before the change happens.

Here is an example of what the response of the API will look like:


“id”: 12345,


“ogos”: {

“id”: 12345,




Phase 2 (February 1st, 2022): No breaking change to GET api/v1/open_graph_objects?url=https://

Then on March 1st, 2022, all public Open Graph Objects (OGOs) will be associated with only the message it is attached to. These links, and the messages associated with them, are only visible to users who have access to the conversations the Open Graph Objects were a part of.

Previously, there was only one OGO in each Yammer Network per absolute URL. Now there will be multiple OGOs that exist because this new change will create one OGO per message the URL is attached to.

GET api/v1/open_graph_objects?url=https:// – will return, in the existing field, any OGO id from the list. In the new field, it will return the full list of OGOs for that url.

The previously stated breaking change is now not happening and the final experience for OGOs at this time will be Phase 2.

Note: If you have not developed custom integration with Yammer or use 3rd party software which includes specific API calls, you can safely ignore this message.

Other Updates (available now)

In addition, if you are using the POST /message.json API and the og_url is a SharePoint URL, to receive a response with metadata for the URL you will need to call this API using an AAD token. Instructions to obtain an AAD token can be found here. Additionally, if using a SharePoint URL do not pass a thumbnail image URL to og_image as Yammer fetches the thumbnail associated with the SharePoint URL.

What do you need to do to prepare?

If your organization is using any of the APIs listed above, ensure that you plan for this change, but no changes should break any custom experiences you have leveraging these Yammer APIs. Also, contact the developers of any 3rd party software that you use to make sure that they are prepared for the coming changes to these Yammer APIs.

Additional information

Message ID: MC283912
Published: 09 September 2021
Updated: 08 March 2022
Effective: 01 March 2022
Action required by date: 01 March 2021
Plan For Change
Product: Azure Active Directory, SharePoint, Yammer
Platform: Developer, World tenant
Change type: Admin impact, Feature update, Updated message

    Ads Blocker Image Powered by Code Help Pro

    Your Support Matters...

    We run an independent site that\'s committed to delivering valuable content, but it comes with its challenges. Many of our readers use ad blockers, causing our advertising revenue to decline. Unlike some websites, we haven\'t implemented paywalls to restrict access. Your support can make a significant difference. If you find this website useful and choose to support us, it would greatly secure our future. We appreciate your help. If you\'re currently using an ad blocker, please consider disabling it for our site. Thank you for your understanding and support.