Events
Power BI DataViz World Championships
14 Feb, 16 - 31 Mar, 16
With 4 chances to enter, you could win a conference package and make it to the LIVE Grand Finale in Las Vegas
Learn moreThis browser is no longer supported.
Upgrade to Microsoft Edge to take advantage of the latest features, security updates, and technical support.
Beginning with the v9.0 release of Dynamics 365, the Web API supports version specific differences in the same environment.
This is different from the behavior for in the v8.x releases. In the previous releases new capabilities were available to any version of the service depending on the update applied to the environment. After an upgrade to v8.2, the v8.0, and v8.1 services were all identical. This was possible because all the changes were additive. Nothing was removed or introduced breaking changes. As a result, the specific version referenced in the service URL for the v8.x wasn't actually important.
Going forward the capabilities of the service can change, including potentially breaking changes such as removing specific operations. This will allow for improvements to be applied on an on-going basis. This topic will record any version specific differences and any limitations where the Web API hasn't yet achieved parity with the SDK for .NET.
Note
While the v9.x releases can support specific differences, there have been no breaking changes added to v9.0, v9.1, or v9.2 releases. Each of these releases are have identical Web API behaviors.
Differences in API behavior is driven more by the solutions installed in the system rather than version of the product. However, if we need to make a fundamental change that is not backward compatible, it will be included in a new version number.
Guidance: Use the version number that was current when your code was written. Do not automatically use a newer version without looking for documented differences here and testing. Do not assume a newer version will be fully backward compatible.
The differences below refer to changes in the v8.2 and v9.0 versions of the Web API.
For v8.x versions, response of FetchXML queries containing link-entities and their attributes contains Unicode special characters such that '.' becomes 'x002e' and '@' becomes 'x0040'. This encoding for special characters is not present in response of FetchXML queries for v9.x release.
If the name of a table (entity) and one of its columns (attributes) is the same, then "1" gets appended to the attribute name in v8.x instances. For example, if an entity new_zipcode has an attribute with name as new_zipcode then, the attribute name will change to new_zipcode1.
For v9.x instances, nothing gets appended to the attribute name.
The following operations have been added to the Web API for the v9.x release.
Operations | Operations (cont'd) | Operations (cont'd) |
---|---|---|
GrantAccessRequest | ModifyAccessRequest | RetrieveSharedPrincipalsAndAccessRequest |
The Dataverse Web API provides complete parity with the capabilities of the SDK for .NET. For Dataverse, this topic describes the limitations carried forward from the Dataverse v8.x release. For earlier releases, see Dynamics CRM 2016 Web API Limitations.
Note
If you defined a custom action which included a complex return value and a simple return value, a corresponding Action was not available in the Web API but was available using the Organization service. A complex return value is an EntityReference
, Entity
, or EntityCollection
. You can have any combination of simple return values or a single complex return value. More information: Create your own actions.
Use the Dataverse Web API
Authenticate to Dataverse with the Web API
Web API types and operations
Perform operations using the Web API
Events
Power BI DataViz World Championships
14 Feb, 16 - 31 Mar, 16
With 4 chances to enter, you could win a conference package and make it to the LIVE Grand Finale in Las Vegas
Learn moreTraining
Module
Work with Microsoft Dataverse Web API - Training
Discover how to work with the Dataverse Web API, including authorizing with OAuth and using OData to query data.
Certification
Microsoft Certified: Dynamics 365: Finance and Operations Apps Developer Associate - Certifications
Implement and extend finance and operation apps in Microsoft Dynamics 365.
Documentation
Microsoft Dataverse Web API Reference
Microsoft Dataverse Web API Reference
Use Insomnia with Dataverse Web API - Power Apps
Learn how to set up and configure Insomnia local Scratch Pad with environments that connect with Microsoft Dataverse environments.
Use the Microsoft Dataverse Web API (Dataverse) - Power Apps
The Microsoft Dataverse Web API implements the OData v4 protocol and provides a development experience that can be used across a wide variety of programming languages, platforms, and devices