# 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)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.whisk.com/resources/authentication-scopes.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
