diff --git a/sdk/PowerBI.Api/Source/Models/Dashboard.cs b/sdk/PowerBI.Api/Source/Models/Dashboard.cs
index 811d724b..f8398b9e 100644
--- a/sdk/PowerBI.Api/Source/Models/Dashboard.cs
+++ b/sdk/PowerBI.Api/Source/Models/Dashboard.cs
@@ -12,7 +12,10 @@ namespace Microsoft.PowerBI.Api.Models
using System.Linq;
///
- /// A Power BI dashboard
+ /// A Power BI dashboard. Below is a list of properties that may be
+ /// returned for a dashboard. Only a subset of the properties will be
+ /// returned depending on the API called, the caller permissions and the
+ /// availability of the data in the Power BI database.
///
public partial class Dashboard
{
diff --git a/sdk/PowerBI.Api/Source/Models/Dataflow.cs b/sdk/PowerBI.Api/Source/Models/Dataflow.cs
index 568bd8f1..ccc464fd 100644
--- a/sdk/PowerBI.Api/Source/Models/Dataflow.cs
+++ b/sdk/PowerBI.Api/Source/Models/Dataflow.cs
@@ -12,7 +12,10 @@ namespace Microsoft.PowerBI.Api.Models
using System.Linq;
///
- /// The metadata of a dataflow
+ /// The metadata of a dataflow. Below is a list of properties that may be
+ /// returned for a dataflow. Only a subset of the properties will be
+ /// returned depending on the API called, the caller permissions and the
+ /// availability of the data in the Power BI database.
///
public partial class Dataflow
{
diff --git a/sdk/PowerBI.Api/Source/Models/Dataset.cs b/sdk/PowerBI.Api/Source/Models/Dataset.cs
index 6ad7101d..092e1c62 100644
--- a/sdk/PowerBI.Api/Source/Models/Dataset.cs
+++ b/sdk/PowerBI.Api/Source/Models/Dataset.cs
@@ -13,7 +13,10 @@ namespace Microsoft.PowerBI.Api.Models
using System.Linq;
///
- /// A Power BI dataset
+ /// A Power BI dataset. Below is a list of properties that may be returned
+ /// for a dataset. Only a subset of the properties will be returned
+ /// depending on the API called, the caller permissions and the
+ /// availability of the data in the Power BI database.
///
public partial class Dataset
{
diff --git a/sdk/PowerBI.Api/Source/Models/Report.cs b/sdk/PowerBI.Api/Source/Models/Report.cs
index 9f794aff..c1bed918 100644
--- a/sdk/PowerBI.Api/Source/Models/Report.cs
+++ b/sdk/PowerBI.Api/Source/Models/Report.cs
@@ -10,7 +10,10 @@ namespace Microsoft.PowerBI.Api.Models
using System.Linq;
///
- /// A Power BI report
+ /// A Power BI report. Below is a list of properties that may be returned
+ /// for a report. Only a subset of the properties will be returned
+ /// depending on the API called, the caller permissions and the
+ /// availability of the data in the Power BI database.
///
public partial class Report
{
diff --git a/sdk/swaggers/swagger.json b/sdk/swaggers/swagger.json
index 3c384488..341f0090 100644
--- a/sdk/swaggers/swagger.json
+++ b/sdk/swaggers/swagger.json
@@ -14427,7 +14427,7 @@
"required": [
"id"
],
- "description": "A Power BI dataset",
+ "description": "A Power BI dataset. Below is a list of properties that may be returned for a dataset. Only a subset of the properties will be returned depending on the API called, the caller permissions and the availability of the data in the Power BI database.",
"properties": {
"id": {
"type": "string",
@@ -15193,7 +15193,7 @@
"required": [
"id"
],
- "description": "A Power BI report",
+ "description": "A Power BI report. Below is a list of properties that may be returned for a report. Only a subset of the properties will be returned depending on the API called, the caller permissions and the availability of the data in the Power BI database.",
"properties": {
"id": {
"type": "string",
@@ -15278,7 +15278,7 @@
"required": [
"id"
],
- "description": "A Power BI dashboard",
+ "description": "A Power BI dashboard. Below is a list of properties that may be returned for a dashboard. Only a subset of the properties will be returned depending on the API called, the caller permissions and the availability of the data in the Power BI database.",
"properties": {
"id": {
"type": "string",
@@ -17081,7 +17081,7 @@
"required": [
"objectId"
],
- "description": "The metadata of a dataflow",
+ "description": "The metadata of a dataflow. Below is a list of properties that may be returned for a dataflow. Only a subset of the properties will be returned depending on the API called, the caller permissions and the availability of the data in the Power BI database.",
"properties": {
"objectId": {
"type": "string",