> 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

A list of supported auth scopes for token generation.

| 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.md">Get your communities.</a></li><li><a href="/api/community/get-communities-by-topic.md">Get communities from a topic.</a></li><li><a href="/api/community/discover-recommended-communities.md">Discover recommended communities.</a></li><li><a href="/api/community/search-communities.md">Search communities.</a></li><li><a href="/api/community/get-a-community.md">Get details of a specific community.</a></li><li><a href="/api/community/get-recipes-from-a-community.md">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.md">Get a list of user's recipes.</a></li><li><a href="/api/recipes/get-recipe-nutrition.md">Get a recipe by ID or URL.</a></li><li><a href="/api/recipes/recipe-search.md">Search recipes.</a></li><li><a href="/api/recipes/user-recipes-and-collections/get-all-user-collections.md">Get a list of user's recipe collections.</a></li><li><a href="/api/recipes/user-recipes-and-collections/get-collection.md">Get a specific recipe collection.</a></li><li><a href="/api/recipes/user-recipes-and-collections/get-recipes-from-a-collection.md">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.md">Create or update a recipe.</a></li><li><a href="/api/recipes/user-recipes-and-collections/updaterecipe.md">Update an external recipe.</a></li><li><a href="/api/recipes/user-recipes-and-collections/create-collection.md">Create a recipe collection.</a></li><li>Update a recipe collection.</li><li><a href="/api/recipes/user-recipes-and-collections/remove-collection.md">Delete a specific recipe collection.</a></li><li><a href="/api/recipes/user-recipes-and-collections/remove-recipe-from-favorites.md">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.md">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://pages/-M3S3x1K5YfYl52FQs74">Create a shopping list.</a></li><li>Move items from one shopping list to another.</li><li><a href="broken://pages/-MK64nEcu4NCgMyrefa8">Delete a shopping list.</a></li><li><a href="broken://pages/-MK65GK4ta3SkAUjWZjB">Edit a shopping list.</a></li><li>Clear items from a shopping list.</li><li><a href="broken://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="/api/meal-plans/meal/meal-plan-management.md">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.md">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.md">Generate a meal plan for a specific period.</a></li><li><a href="/api/meal-plans/meal/delete-meals.md">Clear meals for a specific duration from a particular meal plan.</a></li><li><a href="/api/meal-plans/meal/update-meal.md">Add a meal to a meal plan.</a></li><li><a href="/api/meal-plans/meal/delete-meals.md">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.md">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)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |