> For the complete documentation index, see [llms.txt](https://docs.whisk.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.whisk.com/resources/authentication-scopes.md).

# Authentication Scopes

| Scope                 | Description                                                                                      | Supported API Services                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| --------------------- | ------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `community.read`      | This scope provides you the ability to read a community's data.                                  | <ul><li><a href="/pages/-MRUkJajH2C56fELgffz">Get your communities.</a></li><li><a href="/pages/-MRVh3XnZxbe-XqrxdUI">Get communities from a topic.</a></li><li><a href="/pages/-MRWiGJWNtxaXggHZeju">Discover recommended communities.</a></li><li><a href="/pages/-MRWof8zuY6C6rYVr5u_">Search communities.</a></li><li><a href="/pages/-MRe7-guHmLmgqSvykWB">Get details of a specific community.</a></li><li><a href="/pages/-MReATMkTSRIG9tpZ7k2">Get a recipes from a community.</a></li></ul>                                                                                                    |
| `community.write`     | This scope provides you the ability to edit community's data.                                    | <ul><li>Add recipes to a community.</li><li>Remove a recipe from a community.</li></ul>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| `cookbook:read`       | This scope provides you the ability to read recipes, recipe collections, and custom labels data. | <ul><li><a href="/pages/-M3S3x13nu8ur_zJuADe">Get a list of user's recipes.</a></li><li><a href="/pages/-M3S3x0mHmm3gfEvaPIs">Get a recipe by ID or URL.</a></li><li><a href="/pages/-M3S3x0pHZAAvopwXYNF">Search recipes.</a></li><li><a href="/pages/-M3S3x1-PwEj8C0hbfEe">Get a list of user's recipe collections.</a></li><li><a href="/pages/-M3S3x10SV53hXx1w9Bh">Get a specific recipe collection.</a></li><li><a href="/pages/-M3S3x16yKVwUgHf7Qsi">Get a list of recipes from a specific recipe collection.</a></li><li>Get a list of all custom labels created by the current user.</li></ul> |
| `cookbook:write`      | This scope provides you the ability to edit data of recipes and recipe collections.              | <ul><li><a href="/pages/-M3S3x15MbyZIvY2ON6i">Create or update a recipe.</a></li><li><a href="/pages/-M3S3x0q9oh8SFTtu2jz">Update an external recipe.</a></li><li><a href="/pages/-M3S3x12V4pm0KUUvrnr">Create a recipe collection.</a></li><li>Update a recipe collection.</li><li><a href="/pages/-M3S3x112rmexkmpQ5f8">Delete a specific recipe collection.</a></li><li><a href="/pages/-M3S3x14JyESUtxqQoSU">Delete a recipe from a specific recipe collection.</a></li><li>Add a recipe to multiple recipe collections.</li></ul>                                                                  |
| `food_list:read`      | This scope provides you the ability to read food list data.                                      | Get a food list.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| `food_list:write`     | This scope provides you the ability to edit food list data.                                      | <ul><li>Add an item to a food list.</li><li>Update an item in a food list.</li><li>Delete an item from a food list.</li></ul>                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| `shopping_list:read`  | This scope provides you the ability to read shopping list data.                                  | <ul><li>Get a list of all shopping lists of a user.</li><li><a href="/pages/-M3S3x1LBNk7xTA-Cc1l">Get a shopping list.</a></li></ul>                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| `shopping_list:write` | This scope provides you the ability to edit shopping list data.                                  | <ul><li><a href="/pages/-M3S3x1K5YfYl52FQs74">Create a shopping list.</a></li><li>Move items from one shopping list to another.</li><li><a href="/pages/-MK64nEcu4NCgMyrefa8">Delete a shopping list.</a></li><li><a href="/pages/-MK65GK4ta3SkAUjWZjB">Edit a shopping list.</a></li><li>Clear items from a shopping list.</li><li><a href="/pages/-M3S3x1Je1EN9MnmpDzd">Add items to a shopping list.</a></li><li>Delete an item from a shopping list.</li><li>Update an item in a shopping list.</li></ul>                                                                                           |
| `meal_plan:read`      | This scope provides you the ability to read meal plan data.                                      | <ul><li><a href="/pages/-M4oWupQlg4JB0Ywgx3X">Get meals for a specific period from a meal plan.</a></li><li><a href="/pages/-MN9-crs6JpDQJsHiazT">Get meal plan settings.</a></li></ul>                                                                                                                                                                                                                                                                                                                                                                                                                 |
| `meal_plan:write`     | This scope provides you the ability to edit meal plan data.                                      | <ul><li><a href="/pages/-M4oWupPXR3ZXWQRZAfS">Generate a meal plan for a specific period.</a></li><li><a href="/pages/-M7rEY2LzRX6QrWvqKbN">Clear meals for a specific duration from a particular meal plan.</a></li><li><a href="/pages/-MIVJOIzfBJuWPtQz_OL">Add a meal to a meal plan.</a></li><li><a href="/pages/-M7rEY2LzRX6QrWvqKbN">Remove a meal from a meal plan.</a></li><li>Update a meal in a meal plan.</li><li><a href="/pages/-MN9-_xv7UKRnfxMvysX">Update meal plan settings.</a></li><li>Get a batch of meals.</li><li>Modify a batch of meals.</li></ul>                             |
| `storeitem:read`      | This scope provides you the ability to read a particular store items' data.                      | Get store items.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| `user.profile:read`   | This scope provides you the ability to read a user profile's data.                               | [Get details of a user. ](/api/user-model/get-a-user.md)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| `user.profile:write`  | This scope provides you the ability to edit a user profile's data.                               | [Update details of a user.](/api/user-model/update-a-user.md)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |