diff --git a/aip/general/0131.md b/aip/general/0131.md index c9d9659cd3..7e86bbf96f 100644 --- a/aip/general/0131.md +++ b/aip/general/0131.md @@ -20,9 +20,10 @@ resource. ## Guidance -APIs **should** generally provide a get method for resources unless it is not -valuable for users to do so. The purpose of the get method is to return data -from a single resource. +APIs **must** provide a `Get` method *for resources* and **should** do so otherwise, +unless there is a strong reason not to do so. An example of such, would be if there +is sensitive data that would be included in the response. The purpose of the `Get` method +is to return data from a single resource. Get methods are specified using the following pattern: