PATCH request in Postman

Introduction

A PATCH request lets you update part of a resource on a server without sending the whole data. It saves time and data.

You want to change only the email address of a user without updating their entire profile.

You need to fix a typo in a blog post title without resending the whole post content.

You want to update the status of an order from 'pending' to 'shipped' quickly.

You want to add a new phone number to a contact without changing other details.

Syntax

Postman

PATCH /resource/{id} HTTP/1.1
Host: example.com
Content-Type: application/json

{
  "field_to_update": "new_value"
}

The URL includes the resource ID you want to update.

The request body contains only the fields you want to change.

Examples

Updates only the email of user with ID 123.

Postman

PATCH /users/123 HTTP/1.1
Host: api.example.com
Content-Type: application/json

{
  "email": "[e-mail]"
}

Changes the status of order 456 to 'shipped'.

Postman

PATCH /orders/456 HTTP/1.1
Host: api.example.com
Content-Type: application/json

{
  "status": "shipped"
}

Sample Program

This PATCH request updates the phone number of user 101. Only the phone field is sent, so other user data stays the same.

Postman

PATCH https://api.example.com/users/101 HTTP/1.1
Content-Type: application/json

{
  "phone": "[phone]"
}

Important Notes

PATCH requests should only include fields you want to update, not the whole resource.

Always set the Content-Type header to application/json when sending JSON data.

Check the server response to confirm the update was successful.

Summary

PATCH updates part of a resource without sending everything.

Use PATCH when you want to change only some fields.

Remember to send the correct headers and check the response.

Practice

1. What is the main purpose of a PATCH request in Postman?

easy

A. To update only specific fields of a resource without sending the entire data

B. To create a new resource on the server

C. To delete a resource completely

D. To retrieve data from the server

Solution

1. Step 1: Understand HTTP methods

   PATCH is used to update part of a resource, unlike POST (create) or DELETE (remove).

2. Step 2: Identify PATCH usage in Postman

   PATCH sends only the fields to update, not the whole resource.

3. Final Answer:

   To update only specific fields of a resource without sending the entire data -> Option A

4. Quick Check:

   PATCH updates part of resource = D [OK]

Hint: PATCH updates partial data, not full resource [OK]

Common Mistakes:

• Confusing PATCH with POST or PUT
• Thinking PATCH deletes data
• Assuming PATCH retrieves data

2. Which of the following is the correct way to set a PATCH request body in Postman to update the user's email?

easy

A. { "email": "[e-mail]" }

B. [ "email": "[e-mail]" ]

C. "email": "[e-mail]"

D. [e-mail]

Solution

1. Step 1: Recognize JSON format for PATCH body

   PATCH body must be valid JSON with key-value pairs inside curly braces.

2. Step 2: Check each option's syntax

   { "email": "[e-mail]" } uses correct JSON object syntax. Options A, C, D are invalid JSON or XML.

3. Final Answer:

   { "email": "[e-mail]" } -> Option A

4. Quick Check:

   Valid JSON object = B [OK]

Hint: Use JSON object with braces for PATCH body [OK]

Common Mistakes:

• Using square brackets instead of braces
• Omitting braces around JSON
• Using XML tags instead of JSON

3. Given this PATCH request in Postman to update a user's phone number:

{
  "phone": "[phone]"
}

If the server responds with status 200 and the updated user data including the new phone, what does this indicate?

medium

A. The request failed due to missing fields

B. The entire user data was replaced

C. The server ignored the PATCH request

D. The phone number was successfully updated partially

Solution

1. Step 1: Analyze PATCH request and response

   PATCH updates part of resource; status 200 means success; response shows updated data.

2. Step 2: Interpret server behavior

   Since only phone was sent and updated, server partially updated resource successfully.

3. Final Answer:

   The phone number was successfully updated partially -> Option D

4. Quick Check:

   PATCH success with 200 = partial update C [OK]

Hint: Status 200 + partial data = PATCH success [OK]

Common Mistakes:

• Assuming PATCH replaces entire resource
• Thinking 200 means failure
• Ignoring response content

4. You sent a PATCH request in Postman but received a 400 Bad Request error. Which of these is the most likely cause?

medium

A. The URL is correct but the method should be GET

B. The server does not support PATCH method

C. The request body is missing or malformed JSON

D. The response body is empty

Solution

1. Step 1: Understand 400 Bad Request meaning

   400 means client sent invalid request, often bad syntax or missing data.

2. Step 2: Check PATCH request common errors

   Malformed or missing JSON body is a frequent cause of 400 in PATCH requests.

3. Final Answer:

   The request body is missing or malformed JSON -> Option C

4. Quick Check:

   400 error = bad request body A [OK]

Hint: Check JSON body format if 400 error occurs [OK]

Common Mistakes:

• Confusing 400 with server errors
• Ignoring request body format
• Assuming method is unsupported without checking

5. You want to update a user's profile with a PATCH request in Postman. The user has fields: name, email, and address. You only want to update the address but accidentally send the entire user object with email set to null. What is the likely outcome?

hard

A. Only address updates; email remains unchanged

B. The address updates, but email becomes null on the server

C. The server rejects the request due to null email

D. The entire user profile is deleted

Solution

1. Step 1: Understand PATCH partial update behavior

   PATCH updates fields sent; if a field is sent as null, server may update it to null.

2. Step 2: Analyze sending entire object with null email

   Sending email as null means server likely sets email to null, not ignoring it.

3. Final Answer:

   The address updates, but email becomes null on the server -> Option B

4. Quick Check:

   PATCH sends null field = field updated to null A [OK]

Hint: PATCH null field updates it to null on server [OK]

Common Mistakes:

• Assuming null fields are ignored
• Thinking PATCH only updates non-null fields
• Expecting server to reject null values always