Error Code

Description

Troubleshooting

​

general.badRequest

This error code appears when there is invalid data format found in the request.

Check your request headers and parameters to fix the data formatting issue.

​

general.notFound

This error code appears when an ID of a resource specified in the API request is not found.

• Check if the ID is correct.

• Check if the resource still exists.

Error Code

Description

Troubleshooting

​

auth.tokenExpired

This error code appears when the authentication token in use has expired.

This error usually occurs due to one of the following:

• TTL is greater than 24 hours

• Token is not yet valid or already expired

​

auth.tokenRequired

This error code appears when you forget to use an authentication token in your API request.

Specify the token in the Authorization header, or use it as a query parameter in the request URL.

​

• auth.tokenNotFound

• oauth.unauthorized

​

The auth.tokenNotFound or oauth.unauthorized error usually occurs due to one of the following reasons:

• The token currently in use got deleted when:

  • the user logged out.

  • the app used the refresh token connected to the access token.

• All (user, application) pair tokens got deleted when:

  • the user somehow unlinked the whisk account from the client app.

• All user tokens got deleted when:

  • the user changed the password.

  • the user reset the password.

  • the user used the auth code.

  • the user deleted the whisk account.

Regenerate or request a new token.

Error Code

Description

Troubleshooting

​

authorization.denied

This error code appears when your token has insufficient permission to access a resource.

You may be using the wrong or a different token. Try again with a user access token.

​

authorization.scopeRequired

This error code appears when the authorization token is missing a specific scope that is needed to access a resource.

Regenerate or request a new token with the required scopes.

Description

API Services

Troubleshooting

This error appears when you try to read a topic's data but the topic can't be found.

​

​Get communities from a topic.​

• Check if the topic_id used in the API request is correct.

• Check if the topic still exists on Whisk and has not been deleted.

Description

API Services

Troubleshooting

This error appears when you try to read a community's data but the community can't be found.

​

• ​Get details of a specific community.​

• ​Get a recipes from a community.​

• ​Add recipes to a community.​

• ​Remove a recipe from a community.​

• ​Join a community.​

• ​Leave a community.​

​

• Check if the community_id used in the API request is correct.

• Check if the community still exists on Whisk and has not been

Description

API Services

Troubleshooting

This error appears when you try to add recipes that already exist in the community.

​

​Add recipes to a community.​

Search for the recipe inside the community on Whisk as it may already exist there. If you don't find it there, then check if the recipe ID you used in your API request belongs to the recipe you wanted to add to the community.

Description

API Services

Troubleshooting

This error appears when you try to join a community but you're already member of it.

​

​Join a community.​

Search for the community on Whisk and check if you are already a member there. If it shows you a button join the community, then check the community ID you used in your API request as it may belong to a different community.

Description

API Services

Troubleshooting

This error appears when you try to leave a community but you're not a member of it.

​

​Leave a community.​

Search for the community on Whisk and check if it shows you a button join the community as may not have join it. If shows that you're already a member of it then check the community ID you used in your API request as it may belong to a different community.

Description

API Services

Troubleshooting

This error appears when you try to read a shopping list's data but the shopping list can't be found.

​

• Get a list of all shopping lists of a user.

• ​Get a shopping list.​

• Move items from one shopping list to another.

• ​Delete a shopping list.​

• ​Edit a shopping list.​

• Clear items from a shopping list.

• ​Add items to a shopping list.​

• Delete an item from a shopping list.

• Update an item in a shopping list.

​

• Check if the shopping list id used in the API request is correct.

• Check if the community still exists on Whisk and has not been deleted.

Description

API Services

Troubleshooting

This error appears when you try to read a recipe's data to add items to the shopping list but the recipe can't be found.

​Create a shopping list.​

​

• Check if the recipe_id used in the API request is correct.

• Check if the recipe still exists on Whisk and has not been deleted.

Description

API Services

Troubleshooting

This error appears when you try to read an item from a shopping list but the item can't be found.

​

• Move items from one shopping list to another.

• Delete an item from a shopping list.

• Update an item in a shopping list.

​

​

• Check if the item_id used in the API request is correct.

• Check if the item still exists in the shopping list and has not been deleted.

Description

API Services

Troubleshooting

This error appears when you try to delete a shopping list but it can't be deleted since you have set it as your primary shopping list.

​

​Delete a shopping list.​

Try setting some other shopping list as primary and try again.

Description

API Services

Troubleshooting

This error appears when you try to generate a meal plan for an incorrect period of time.

​

• ​Generate a meal plan for a specific period.​

• ​Get meals for a specific period from a meal plan.​

• ​Clear meals for a specific duration from a particular meal plan.​

Check if the period attribute used in the request is correctly specified. The correct format can be found in the related endpoint description topic.

Description

API Services

Troubleshooting

This error appears when you try to read a meal plan's data but the meal plan can't be found.

​

• ​Generate a meal plan for a specific period.​

• ​Clear meals for a specific duration from a particular meal plan.​

• ​Add a meal to a meal plan.​

• ​Remove a meal from a meal plan.​

• Update a meal in a meal plan.

• ​Update meal plan settings.​

• ​Get meals for a specific period from a meal plan.​

• ​Get meal plan settings.​

​

• Check if the meal_plan_id used in the API request is correct.

• Check if the meal plan still exists on Whisk and has not been deleted.

Description

API Services

Troubleshooting

This error appears when you try to add or update a meal in a meal plan but the requested slot is already occupied by another meal.

​

• ​Add a meal to a meal plan.​

• Update a meal in a meal plan.

• Check if the requested slot is correct.

• Clear the slot and try again.

Description

API Services

Troubleshooting

This error appears when you exceed the number of meals allowed in a day.

​

• ​Add a meal to a meal plan.​

• Update a meal in a meal plan.

• Modify a batch of meals.

Check if you already have 7 meals, which is the maximum number of meals you can have set for the day.

Description

API Services

Troubleshooting

This error appears when you try to read or edit a meal in a meal plan but the meal can't be found.

​

• Update a meal in a meal plan.

• ​Remove a meal from a meal plan.​

• Modify a batch of meals.

​

• Check if the meal_id used in the API request is correct.

• Check if the meal still exists in the meal plan and has not been deleted.

Description

API Services

Troubleshooting

This error appears when you try to write meal plan settings for generating or updating a meal plan but the data specified is incorrect.

​

• ​Generate a meal plan for a specific period.​

• ​Update meal plan settings.​

• Check Meal Plan Settings to see if you have correctly defined the data.

Description

API Services

Troubleshooting

This error appears when you exceed the number of meals allowed in a week.

​

Modify a batch of meals.

Check if you already have 50 meals, which is the maximum number of meals you can have set for the week.

Description

API Services

Troubleshooting

This error appears when your request contains incorrect parameters.

​

• ​Get a recipe by ID or URL.​

• ​Search recipes.​

• ​Create or update a recipe.​

• ​Update an external recipe.​

Check the Recipe API documentation to see if your API request is correctly formed.

Description

API Services

Troubleshooting

This error appears when you try to add a recipe but the recipe already exists.

​

​Create or update a recipe.​

You maybe adding a recipe that already existing

Description

API Services

Troubleshooting

This error appears when you try to read or edit a recipe's data but the recipe can't be found.

​

• ​Create or update a recipe.​

• ​Update an external recipe.​

• ​Delete a recipe from a specific recipe collection.​

​

• Check if the recipe_id or recipe URL used in the API request is correct.

• Check if the recipe still exists and has not been deleted.

Description

API Services

Troubleshooting

This error appears when you try to read store items data but your request contains incorrect parameters.

Get store items.

Check the Store API documentation to see if your API request is correctly formed.