You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: README.md
+35-5
Original file line number
Diff line number
Diff line change
@@ -60,10 +60,12 @@ In addition, request bodies for `PUT`, `POST`, `REPORT` and `PATCH` requests mus
60
60
61
61
### Summary and detailed representations
62
62
63
-
When you fetch a list of resources, the response includes only the most important attributes of each resource. This is a _summary representation_ of the resource. When you fetch an individual resource (for example, a single feature flag), you receive a _detailed representation_ containing all of the attributes of the resource.
63
+
When you fetch a list of resources, the response includes only the most important attributes of each resource. This is a _summary representation_ of the resource. When you fetch an individual resource, such as a single feature flag, you receive a _detailed representation_ of the resource.
64
64
65
65
The best way to find a detailed representation is to follow links. Every summary representation includes a link to its detailed representation.
66
66
67
+
In most cases, the detailed representation contains all of the attributes of the resource. In a few cases, the detailed representation contains many, but not all, of the attributes of the resource. Typically this happens when an attribute of the requested resource is itself paginated. You can request that the response include a particular attribute by using the `expand` request parameter.
68
+
67
69
### Links and addressability
68
70
69
71
The best way to navigate the API is by following links. These are attributes in representations that link to other resources. The API always uses the same format for links:
@@ -98,6 +100,12 @@ Collections are always represented as a JSON object with an `items` attribute co
98
100
99
101
Paginated collections include `first`, `last`, `next`, and `prev` links containing a URL with the respective set of elements in the collection.
100
102
103
+
### Expanding responses
104
+
105
+
Sometimes the detailed representation of a resource does not include all of the attributes of the resource by default. If this is the case, the request method will clearly document this and describe which attributes you can include in an expanded response.
106
+
107
+
To include the additional attributes, append the `expand` request parameter to your request and add a comma-separated list of the attributes to include. For example, when you append `?expand=members,roles` to the [Get team](/tag/Teams-(beta)#operation/getTeam) endpoint, the expanded response includes both of these attributes.
108
+
101
109
## Updates
102
110
103
111
Resources that accept partial updates use the `PATCH` verb, and support the [JSON Patch](https://datatracker.ietf.org/doc/html/rfc6902) format. Some resources also support the [JSON Merge Patch](https://datatracker.ietf.org/doc/html/rfc7386) format. In addition, some resources support optional comments that can be submitted with updates. Comments appear in outgoing webhooks, the audit log, and other integrations.
@@ -395,7 +403,7 @@ We mark beta resources with a \"Beta\" callout in our documentation, pictured be
395
403
396
404
> ### This feature is in beta
397
405
>
398
-
> To use this feature, pass in a header including the `LD-API-Version` key with value set to `beta`. Use this header with each call. To learn more, read [Beta resources](/#section/Beta-resources).
406
+
> To use this feature, pass in a header including the `LD-API-Version` key with value set to `beta`. Use this header with each call. To learn more, read [Beta resources](/#section/Overview/Beta-resources).
399
407
400
408
### Using beta resources
401
409
@@ -448,7 +456,7 @@ If you would like to upgrade your integration to use a new API version, you can
448
456
This SDK is automatically generated by the [OpenAPI Generator](https://openapi-generator.tech) project:
0 commit comments