Postman POST PUT DELETE Requests
GET requests only read data. POST, PUT, PATCH, and DELETE requests make changes — they create, update, or remove data on a server. This topic covers all four with clear examples and diagrams.
The CRUD Model
Every API is built around four actions called CRUD. Each HTTP method maps to one of these actions:
| CRUD Action | HTTP Method | What It Does |
|---|---|---|
| Create | POST | Adds a new record |
| Read | GET | Fetches existing data |
| Update | PUT / PATCH | Changes an existing record |
| Delete | DELETE | Removes a record |
POST – Create New Data
A POST request sends new data to the server to be saved. Think of filling in a registration form and clicking Submit — that button triggers a POST request.
You (Postman) The Server
│ │
│── POST /posts ──────────▶ │
│ Body: { title, body } │ (Server saves the new post)
│◀── 201 Created ────────── │
│ │
Send a POST Request
- Open a new request tab in Postman
- Change the method dropdown to POST
- Enter this URL: https://jsonplaceholder.typicode.com/posts
- Click the Body tab below the URL bar
- Select the raw radio button
- Choose JSON from the format dropdown that appears on the right
- Paste this into the text area:
{ "title": "My First Post", "body": "This is the content of my post.", "userId": 1 } - Click Send
The server responds with 201 Created and returns the new post with an ID assigned to it. This is not a real save on the test server, but it shows you exactly how a real POST works.
PUT – Replace an Entire Record
A PUT request replaces all the data in an existing record. If you send only some fields, the missing fields get wiped. Use PUT when you want to overwrite the whole record.
You (Postman) The Server
│ │
│── PUT /posts/1 ────────────────▶ │
│ Body: { title, body, userId } │ (Server replaces post 1)
│◀── 200 OK ────────────────────── │
│ │
Send a PUT Request
- Change the method to PUT
- Use this URL: https://jsonplaceholder.typicode.com/posts/1
- In the Body tab, use raw JSON:
{ "id": 1, "title": "Updated Title", "body": "Updated content.", "userId": 1 } - Click Send
A 200 OK response confirms the server accepted the update.
PATCH – Update Part of a Record
A PATCH request changes only the fields you send. All other fields stay the same. Use PATCH when you want to change a single detail, like updating just the title of a blog post.
Send a PATCH Request
- Change the method to PATCH
- Use this URL: https://jsonplaceholder.typicode.com/posts/1
- In the Body tab, use raw JSON with only the field you want to change:
{ "title": "Only the Title Changed" } - Click Send
The server returns the updated post. Only the title changed. The body and userId remain untouched.
PUT vs PATCH – Key Difference
| PUT | PATCH | |
|---|---|---|
| Sends | Complete record | Only changed fields |
| Missing fields | Get erased | Stay unchanged |
| Use when | Replacing everything | Updating one or two fields |
DELETE – Remove a Record
A DELETE request tells the server to remove a resource. You usually do not send a body with DELETE — the URL itself identifies what to remove.
You (Postman) The Server
│ │
│── DELETE /posts/1 ─────▶ │
│ │ (Server removes post 1)
│◀── 200 OK ───────────── │
│ │
Send a DELETE Request
- Change the method to DELETE
- Use this URL: https://jsonplaceholder.typicode.com/posts/1
- Do not add anything in the Body tab
- Click Send
The test server returns 200 OK with an empty body {}, confirming the deletion.
Summary of Status Codes for Each Method
| Method | Common Success Code | What It Means |
|---|---|---|
| POST | 201 Created | New record was created |
| PUT | 200 OK | Record was replaced |
| PATCH | 200 OK | Record was partially updated |
| DELETE | 200 OK or 204 No Content | Record was deleted |
Summary
POST creates new data. PUT replaces an entire record. PATCH updates only the fields you specify. DELETE removes a record. The URL targets the resource and the HTTP method tells the server what action to take on it.
