Skip to content

Commit 62a5b44

Browse files
committed
Updated based on feedback and triage with Olga.
1 parent 9f5ef0e commit 62a5b44

File tree

1 file changed

+4
-4
lines changed

1 file changed

+4
-4
lines changed

graph/patterns/default-properties.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -2,17 +2,17 @@
22

33
Microsoft Graph API Design Pattern
44

5-
*The default properties pattern allows API producers to omit specific properties from the response unless they are explicitly requested using `$select`. The pattern also uses an instance annotation to inform callers that other properties are also available. The same annotation is also use to encourage callers to use `$select`.*
5+
*The default properties pattern allows API producers to omit specific properties from the response unless they are explicitly requested using `$select`.*
66

77
## Problem
88

9-
API producers want to control the set of properties that their entities return by default, when the incoming request does not specify a `$select`. This can be desirable when an entity type has many properties or an API producer needs to add properties that are computationally expensive to return by default.
9+
API designers want to control the set of properties that their entities return by default, when the incoming request does not specify a `$select`. This can be desirable when an entity type has many properties or an API producer needs to add properties that are computationally expensive to return by default.
1010

1111
## Solution
1212

13-
For incoming requests targeting an entity type where the caller does not specify a `$select`` clause, API producers **may** return a subset of the entity type's properties, omitting computationally expensive properties.
13+
For incoming requests targeting an entity type where the caller does not specify a `$select` clause, API producers **may** return a subset of the entity type's properties, omitting computationally expensive properties. To get the non-default properties of an entity type, callers must explicitly request them using `$select`.
1414

15-
To get the non-default properties of an entity type, callers must explicitly request them using `$select`.
15+
The pattern also uses an instance annotation to inform callers that other properties are also available. The same annotation is also used to encourage callers to use `$select`.
1616

1717
## When to use this pattern
1818

0 commit comments

Comments
 (0)