Microsoft Graph API contacts delta

Matteo Rigon 0 Reputation points
2024-03-27T15:07:57.9733333+00:00

Hello,

when browsing the Microsoft Graph API documentation, to get delta changes of contacts for a user the only available endpoint looks like it's https://learn.microsoft.com/en-us/graph/api/contact-delta?view=graph-rest-1.0&tabs=http, which requires passing a contact folder.

However, it looks there is also another undocumented endpoint that does not require a contact folder /me/contacts/delta , but it's not documented anywhere ( although you can find it in the Microsoft Graph Explorer, see screenshot ).Screenshot 2024-03-27 at 16.04.13

Is this API safe to use? I couldn't find any mention of it being deprecated in the Microsoft Graph changelog, but it's very weird there is no documentation anywhere. If on the graph explorer you click the documention icon you get redirected to the new delta docs that requires the contact folder

Microsoft Graph
Microsoft Graph
A Microsoft programmability model that exposes REST APIs and client libraries to access data on Microsoft 365 services.
10,592 questions
0 comments No comments
{count} votes

1 answer

Sort by: Most helpful
  1. CarlZhao-MSFT 36,976 Reputation points
    2024-03-28T10:04:57.6933333+00:00

    Hi @Matteo Rigon

    /delta is a shortcut for the fully qualified name /microsoft.graph.delta, which means that the /me/contacts/microsoft.graph.delta() endpoint is equivalent to /me/contacts/delta.

    The /me/contacts/delta endpoint does not appear require a contact folder, but this endpoint is not yet documented, and its lack of official documentation raises questions about its safety and reliability for use.

    Remember that using undocumented endpoints carries some risk, so proceed with caution. If possible, rely on the documented endpoint until more information becomes available.

    Hope this helps.

    If the reply is helpful, please click Accept Answer and kindly upvote it. If you have additional questions about this answer, please click Comment.