Complete CRUD API for managing recipes built with Node.js, Express.js, and Mongoose.
\nBase URL: http://localhost:5000
Verify the API server is running.
\n","urlObject":{"path":[""],"host":["http://localhost:5000"],"query":[],"variable":[]}},"response":[{"id":"a87c7e9f-4b13-4941-a5b8-bd896d08539e","name":"Server Running","originalRequest":{"method":"GET","header":[],"url":"http://localhost:5000/","description":"Verify the API server is running."},"status":"OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\n \"success\": true,\n \"message\": \"🍽️ Recipes API is running\",\n \"version\": \"1.0.0\",\n \"endpoints\": {\n \"recipes\": \"/api/recipes\"\n }\n}"}],"_postman_id":"63bea375-5960-487b-bbd0-7c20e604358c"},{"name":"1. Create Recipe","id":"2ad7970a-b7e9-4b06-a410-10f62ccfa663","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"title\": \"Classic Spaghetti Carbonara\",\n \"description\": \"A rich and creamy Italian pasta dish made with eggs, cheese, pancetta, and black pepper.\",\n \"ingredients\": [\n \"400g spaghetti\",\n \"200g pancetta or guanciale\",\n \"4 large eggs\",\n \"100g Pecorino Romano cheese\",\n \"50g Parmesan cheese\",\n \"2 cloves garlic\",\n \"Salt and black pepper to taste\"\n ],\n \"instructions\": \"1. Cook spaghetti in salted boiling water until al dente.\\n2. Fry pancetta with garlic until crispy.\\n3. Whisk eggs with grated cheeses.\\n4. Reserve pasta water, drain pasta.\\n5. Off heat, mix pasta with pancetta, then egg mixture.\\n6. Add pasta water to achieve creamy texture.\\n7. Season generously with black pepper and serve.\",\n \"category\": \"Dinner\",\n \"prepTime\": 10,\n \"cookTime\": 20,\n \"servings\": 4,\n \"difficulty\": \"Medium\",\n \"imageUrl\": \"https://example.com/carbonara.jpg\"\n}","options":{"raw":{"language":"json"}}},"url":"http://localhost:5000/api/recipes","description":"createRecipe — Creates a new recipe document in MongoDB.
\ntitle (string, max 100 chars)description (string, max 500 chars)ingredients (array of strings, min 1 item)instructions (string)category (enum: Breakfast | Lunch | Dinner | Snack | Dessert | Beverage | Other)prepTime (number, minutes)cookTime (number, minutes)servings (number, min 1)difficulty (enum: Easy | Medium | Hard, default: Easy)imageUrl (string)getAllRecipes — Retrieves all recipes from the database, sorted by newest first.
\ncategory — Filter by category (e.g. Dinner, Breakfast)difficulty — Filter by difficulty (Easy, Medium, Hard)search — Search by title keyword (case-insensitive)Filter by category (optional)
\n","type":"text/plain"},"key":"category","value":"Dinner"},{"disabled":true,"description":{"content":"Filter by difficulty (optional)
\n","type":"text/plain"},"key":"difficulty","value":"Easy"},{"disabled":true,"description":{"content":"Search by title keyword (optional)
\n","type":"text/plain"},"key":"search","value":"pasta"}],"variable":[]}},"response":[{"id":"b45b87eb-e4de-4be7-8b03-2fc93f8c612e","name":"200 - All Recipes","originalRequest":{"method":"GET","header":[],"url":{"raw":"http://localhost:5000/api/recipes","host":["http://localhost:5000"],"path":["api","recipes"],"query":[{"key":"category","value":"Dinner","description":"Filter by category (optional)","disabled":true},{"key":"difficulty","value":"Easy","description":"Filter by difficulty (optional)","disabled":true},{"key":"search","value":"pasta","description":"Search by title keyword (optional)","disabled":true}]},"description":"**getAllRecipes** — Retrieves all recipes from the database, sorted by newest first.\n\n### Query Parameters (all optional)\n- `category` — Filter by category (e.g. `Dinner`, `Breakfast`)\n- `difficulty` — Filter by difficulty (`Easy`, `Medium`, `Hard`)\n- `search` — Search by title keyword (case-insensitive)"},"status":"OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\n \"success\": true,\n \"count\": 2,\n \"data\": [\n {\n \"_id\": \"665a1b2c3d4e5f6789012345\",\n \"title\": \"Classic Spaghetti Carbonara\",\n \"description\": \"A rich and creamy Italian pasta dish.\",\n \"ingredients\": [\"400g spaghetti\", \"200g pancetta\"],\n \"category\": \"Dinner\",\n \"prepTime\": 10,\n \"cookTime\": 20,\n \"servings\": 4,\n \"difficulty\": \"Medium\",\n \"createdAt\": \"2024-06-01T10:00:00.000Z\",\n \"updatedAt\": \"2024-06-01T10:00:00.000Z\"\n },\n {\n \"_id\": \"665a1b2c3d4e5f6789099999\",\n \"title\": \"Avocado Toast\",\n \"description\": \"Quick healthy breakfast.\",\n \"ingredients\": [\"2 slices sourdough\", \"1 avocado\"],\n \"category\": \"Breakfast\",\n \"prepTime\": 5,\n \"cookTime\": 3,\n \"servings\": 1,\n \"difficulty\": \"Easy\",\n \"createdAt\": \"2024-05-30T08:00:00.000Z\",\n \"updatedAt\": \"2024-05-30T08:00:00.000Z\"\n }\n ]\n}"}],"_postman_id":"d1fe9f8b-8db1-4b16-b0c8-ab3f258306cd"},{"name":"3. Get Recipe by ID","id":"eb8cd63d-27c5-4727-9d0e-0298ef9b3062","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"http://localhost:5000/api/recipes/","description":"getRecipeById — Retrieves a single recipe by its MongoDB ObjectId.
\n:id — The MongoDB ObjectId of the recipe (24-character hex string)updateRecipe — Updates an existing recipe by its ID. Only include fields you want to change.
\n:id — The MongoDB ObjectId of the recipeSend only the fields you wish to update. All schema validations still apply.
\n","urlObject":{"path":["api","recipes",""],"host":["http://localhost:5000"],"query":[],"variable":[]}},"response":[{"id":"ccc2dd0e-e747-47fe-92e8-38021dbc70a7","name":"200 - Recipe Updated","originalRequest":{"method":"PUT","header":[{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"title\": \"Classic Spaghetti Carbonara (Updated)\",\n \"servings\": 6,\n \"difficulty\": \"Hard\",\n \"description\": \"An authentic Roman pasta dish — richer and even more delicious.\"\n}","options":{"raw":{"language":"json"}}},"url":"http://localhost:5000/api/recipes/","description":"**updateRecipe** — Updates an existing recipe by its ID. Only include fields you want to change.\n\n### URL Parameter\n- `:id` — The MongoDB ObjectId of the recipe\n\n### Body\nSend only the fields you wish to update. All schema validations still apply."},"status":"OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\n \"success\": true,\n \"message\": \"Recipe updated successfully\",\n \"data\": {\n \"_id\": \"665a1b2c3d4e5f6789012345\",\n \"title\": \"Classic Spaghetti Carbonara (Updated)\",\n \"description\": \"An authentic Roman pasta dish — richer and even more delicious.\",\n \"ingredients\": [\"400g spaghetti\", \"200g pancetta\"],\n \"category\": \"Dinner\",\n \"prepTime\": 10,\n \"cookTime\": 20,\n \"servings\": 6,\n \"difficulty\": \"Hard\",\n \"createdAt\": \"2024-06-01T10:00:00.000Z\",\n \"updatedAt\": \"2024-06-01T11:30:00.000Z\"\n }\n}"},{"id":"dbd19799-264c-43b3-b389-a4cc48fa1046","name":"404 - Recipe Not Found","originalRequest":{"method":"PUT","header":[{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"title\": \"Classic Spaghetti Carbonara (Updated)\",\n \"servings\": 6,\n \"difficulty\": \"Hard\",\n \"description\": \"An authentic Roman pasta dish — richer and even more delicious.\"\n}","options":{"raw":{"language":"json"}}},"url":"http://localhost:5000/api/recipes/","description":"**updateRecipe** — Updates an existing recipe by its ID. Only include fields you want to change.\n\n### URL Parameter\n- `:id` — The MongoDB ObjectId of the recipe\n\n### Body\nSend only the fields you wish to update. All schema validations still apply."},"status":"Not Found","code":404,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\n \"success\": false,\n \"message\": \"Recipe not found with ID: 665a1b2c3d4e5f6789012345\"\n}"}],"_postman_id":"da178019-10d2-49e1-a5bd-cd7d8c544c0c"},{"name":"5. Delete Recipe","id":"af46c711-8eb6-4f00-bf0c-2eeece845e62","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"DELETE","header":[],"url":"http://localhost:5000/api/recipes/","description":"deleteRecipe — Permanently deletes a recipe by its ID.
\n:id — The MongoDB ObjectId of the recipe to delete\n\n","urlObject":{"path":["api","recipes",""],"host":["http://localhost:5000"],"query":[],"variable":[]}},"response":[{"id":"81774e89-61e3-4c05-aec6-57a7d118ec45","name":"200 - Recipe Deleted","originalRequest":{"method":"DELETE","header":[],"url":"http://localhost:5000/api/recipes/","description":"**deleteRecipe** — Permanently deletes a recipe by its ID.\n\n### URL Parameter\n- `:id` — The MongoDB ObjectId of the recipe to delete\n\n> ⚠️ This action is irreversible."},"status":"OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\n \"success\": true,\n \"message\": \"Recipe deleted successfully\",\n \"data\": {}\n}"},{"id":"e275782e-1be3-463a-94c4-a813ab0efd66","name":"404 - Recipe Not Found","originalRequest":{"method":"DELETE","header":[],"url":"http://localhost:5000/api/recipes/","description":"**deleteRecipe** — Permanently deletes a recipe by its ID.\n\n### URL Parameter\n- `:id` — The MongoDB ObjectId of the recipe to delete\n\n> ⚠️ This action is irreversible."},"status":"Not Found","code":404,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\n \"success\": false,\n \"message\": \"Recipe not found with ID: 665a1b2c3d4e5f6789012345\"\n}"}],"_postman_id":"af46c711-8eb6-4f00-bf0c-2eeece845e62"}],"variable":[{"key":"baseUrl","value":"http://localhost:5000","description":"Change this to your deployed Render URL for production"},{"key":"recipeId","value":"","description":"Store a recipe ID here after creating one"}]}⚠️ This action is irreversible.
\n