Partially update a person with a JSON merge patch

PATCHhttps://api.testingapis.com/api/People/{id}Sign in to see this endpoint's URL

Only the fields present in the body change, and nested objects are merged rather than replaced. The ID and unknown fields are never applied; they are listed in ignored. The patched record is validated before it is saved, so a rejected patch changes nothing.

Parameters 1

Name	Type	Description
`id`required	path · integer (int32)	Record ID.

Request body

Optional. application/json, text/json, application/*+json, application/xml, text/xml, application/*+xml. JSON object with the fields to change, e.g. { "price": 12.5 }.

Example body

{"firstName": "Aisha"}

Responses

200: Patched; returns { message, changed, ignored, data }.
400: The body is not an object, sets a non-nullable field to null, has a wrongly typed value, or the result fails validation.
404: No record has this ID.

Example

Request

curl -X PATCH "https://api.testingapis.com/api/People/21" \
  -H "Content-Type: application/json" \
  -d '{"firstName": "Aisha"}' \
  -H "X-TestingApis-Key: YOUR_API_KEY"

Response200 OK

{
  "message": "Person patched successfully",
  "changed": ["firstName"],
  "ignored": [],
  "data": {
    "id": 21,
    "firstName": "Aisha",
    "lastName": "Khan",
    "username": "akhan",
    "email": "akhan@example.com",
    "gender": "female",
    "dateOfBirth": "1991-04-12",
    "phone": "+1-555-200-3000",
    "avatar": "https://i.pravatar.cc/150?img=1",
… (11 more lines)

The parameters, request and response examples and the live Try it panel for this endpoint are for signed-in members. Accounts are free and take a few seconds to create.

Try itSign-in requiredUses your key

api.testingapis.com

curl -X PATCH 'https://api.testingapis.com/api/People/21' \
  -H 'Content-Type: application/json' \
  -H 'X-TestingApis-Key: YOUR_API_KEY' \
  -d '{"firstName": "Aisha"}'

const res = await fetch("https://api.testingapis.com/api/People/21", {
  method: "PATCH",
  headers: {
    "Content-Type": "application/json",
    "X-TestingApis-Key": "YOUR_API_KEY",
  },
  body: "{\"firstName\": \"Aisha\"}",
});
console.log(res.status, await res.text());

const res = await fetch("https://api.testingapis.com/api/People/21", {
  method: "PATCH",
  headers: {
    "Content-Type": "application/json",
    "X-TestingApis-Key": "YOUR_API_KEY",
  },
  body: "{\"firstName\": \"Aisha\"}",
});
const body: string = await res.text();
console.log(res.status, body);

import requests

res = requests.patch(
    "https://api.testingapis.com/api/People/21",
    headers={
        "Content-Type": "application/json",
        "X-TestingApis-Key": "YOUR_API_KEY",
    },
    data="{\"firstName\": \"Aisha\"}",
)
print(res.status_code, res.text)

using System.Net.Http.Headers;

using var client = new HttpClient();
using var request = new HttpRequestMessage(HttpMethod.Patch, "https://api.testingapis.com/api/People/21");
request.Headers.TryAddWithoutValidation("X-TestingApis-Key", "YOUR_API_KEY");
request.Content = new StringContent("{\"firstName\": \"Aisha\"}");
request.Content.Headers.ContentType = MediaTypeHeaderValue.Parse("application/json");
using var response = await client.SendAsync(request);
Console.WriteLine($"{(int)response.StatusCode} {await response.Content.ReadAsStringAsync()}");

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

public class Main {
    public static void main(String[] args) throws Exception {
        HttpClient client = HttpClient.newHttpClient();
        HttpRequest request = HttpRequest.newBuilder(URI.create("https://api.testingapis.com/api/People/21"))
                .header("X-TestingApis-Key", "YOUR_API_KEY")
                .header("Content-Type", "application/json")
                .method("PATCH", HttpRequest.BodyPublishers.ofString("{\"firstName\": \"Aisha\"}"))
                .build();
        HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
        System.out.println(response.statusCode() + " " + response.body());
    }
}

package main

import (
	"fmt"
	"io"
	"net/http"
	"strings"
)

func main() {
	body := strings.NewReader("{\"firstName\": \"Aisha\"}")
	req, err := http.NewRequest("PATCH", "https://api.testingapis.com/api/People/21", body)
	if err != nil {
		panic(err)
	}
	req.Header.Set("X-TestingApis-Key", "YOUR_API_KEY")
	req.Header.Set("Content-Type", "application/json")
	res, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer res.Body.Close()
	data, err := io.ReadAll(res.Body)
	if err != nil {
		panic(err)
	}
	fmt.Println(res.StatusCode, string(data))
}

PATCHhttps://api.testingapis.com/api/People/21

Path

idrequiredinteger (int32)