# 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="../api/community/get-your-communities">Get your communities.</a></li><li><a href="../api/community/get-communities-by-topic">Get communities from a topic.</a></li><li><a href="../api/community/discover-recommended-communities">Discover recommended communities.</a></li><li><a href="../api/community/search-communities">Search communities.</a></li><li><a href="../api/community/get-a-community">Get details of a specific community.</a></li><li><a href="../api/community/get-recipes-from-a-community">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="../api/recipes/user-recipes-and-collections/get-all-user-recipes">Get a list of user's recipes.</a></li><li><a href="../api/recipes/get-recipe-nutrition">Get a recipe by ID or URL.</a></li><li><a href="../api/recipes/recipe-search">Search recipes.</a></li><li><a href="../api/recipes/user-recipes-and-collections/get-all-user-collections">Get a list of user's recipe collections.</a></li><li><a href="../api/recipes/user-recipes-and-collections/get-collection">Get a specific recipe collection.</a></li><li><a href="../api/recipes/user-recipes-and-collections/get-recipes-from-a-collection">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="../api/recipes/user-recipes-and-collections/add-user-recipe">Create or update a recipe.</a></li><li><a href="../api/recipes/user-recipes-and-collections/updaterecipe">Update an external recipe.</a></li><li><a href="../api/recipes/user-recipes-and-collections/create-collection">Create a recipe collection.</a></li><li>Update a recipe collection.</li><li><a href="../api/recipes/user-recipes-and-collections/remove-collection">Delete a specific recipe collection.</a></li><li><a href="../api/recipes/user-recipes-and-collections/remove-recipe-from-favorites">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="../api/shopping-lists/get-shopping-lists">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="broken-reference">Create a shopping list.</a></li><li>Move items from one shopping list to another.</li><li><a href="broken-reference">Delete a shopping list.</a></li><li><a href="broken-reference">Edit a shopping list.</a></li><li>Clear items from a shopping list.</li><li><a href="broken-reference">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="../api/meal-plans/meal/meal-plan-management">Get meals for a specific period from a meal plan.</a></li><li><a href="../api/meal-plans/get-meal-plan-settings/get-meal-plan-settings">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="../api/meal-plans/generate_mealplan">Generate a meal plan for a specific period.</a></li><li><a href="../api/meal-plans/meal/delete-meals">Clear meals for a specific duration from a particular meal plan.</a></li><li><a href="../api/meal-plans/meal/update-meal">Add a meal to a meal plan.</a></li><li><a href="../api/meal-plans/meal/delete-meals">Remove a meal from a meal plan.</a></li><li>Update a meal in a meal plan.</li><li><a href="../api/meal-plans/get-meal-plan-settings/update-meal-plan-settings">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. ](https://docs.whisk.com/api/user-model/get-a-user)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| `user.profile:write`  | This scope provides you the ability to edit a user profile's data.                               | [Update details of a user.](https://docs.whisk.com/api/user-model/update-a-user)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |