Replace a country

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

Every field is overwritten with the body; the ID from the route wins over any ID in the body.

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. Model: Country. The full replacement record.

Example body

{
  "name": "United States",
  "code": "US",
  "code3": "USA",
  "capital": "Washington, D.C.",
  "region": "Americas",
  "population": 331900000,
  "area": 9833520,
  "currency": {"code": "USD", "name": "United States dollar", "symbol": "$"},
  "languages": ["English"],
  "callingCode": "+1",
  "flag": "🇺🇸",
  "timezones": ["UTC-05:00", "UTC-06:00", "… 2 more items"]
}

Responses

200: Replaced; returns { message, data }.
400: The body is missing, malformed or fails validation.
404: No record has this ID.

Example

Request

curl -X PUT "https://api.testingapis.com/api/Countries/31" \
  -H "Content-Type: application/json" \
  -d '{"name": "United States", "code": "US", "code3": "USA", "capital": "Washington, D.C.", "region": "Americas", "population": 331900000, "area": 9833520, "currency": {"code": "USD", "name": "United States dollar", "symbol": "$"}, "languages": ["English"], "callingCode": "+1", "flag": "🇺🇸", "timezones": ["UTC-05:00", "UTC-06:00", "… 2 more items"]}' \
  -H "X-TestingApis-Key: YOUR_API_KEY"

Response200 OK

{
  "message": "Country updated successfully",
  "data": {
    "id": 31,
    "name": "United States",
    "code": "US",
    "code3": "USA",
    "capital": "Washington, D.C.",
    "region": "Americas",
    "population": 331900000,
    "area": 9833520,
    "currency": {"code": "USD", "name": "United States dollar", "symbol": "$"},
    "languages": ["English"],
    "callingCode": "+1",
… (4 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 PUT 'https://api.testingapis.com/api/Countries/31' \
  -H 'Content-Type: application/json' \
  -H 'X-TestingApis-Key: YOUR_API_KEY' \
  -d '{"name": "United States", "code": "US", "code3": "USA", "capital": "Washington, D.C.", "region": "Americas", "population": 331900000, "area": 9833520, "currency": {"code": "USD", "name": "United States dollar", "symbol": "$"}, "languages": ["English"], "callingCode": "+1", "flag": "🇺🇸", "timezones": ["UTC-05:00", "UTC-06:00", "… 2 more items"]}'

const res = await fetch("https://api.testingapis.com/api/Countries/31", {
  method: "PUT",
  headers: {
    "Content-Type": "application/json",
    "X-TestingApis-Key": "YOUR_API_KEY",
  },
  body: "{\"name\": \"United States\", \"code\": \"US\", \"code3\": \"USA\", \"capital\": \"Washington, D.C.\", \"region\": \"Americas\", \"population\": 331900000, \"area\": 9833520, \"currency\": {\"code\": \"USD\", \"name\": \"United States dollar\", \"symbol\": \"$\"}, \"languages\": [\"English\"], \"callingCode\": \"+1\", \"flag\": \"🇺🇸\", \"timezones\": [\"UTC-05:00\", \"UTC-06:00\", \"… 2 more items\"]}",
});
console.log(res.status, await res.text());

const res = await fetch("https://api.testingapis.com/api/Countries/31", {
  method: "PUT",
  headers: {
    "Content-Type": "application/json",
    "X-TestingApis-Key": "YOUR_API_KEY",
  },
  body: "{\"name\": \"United States\", \"code\": \"US\", \"code3\": \"USA\", \"capital\": \"Washington, D.C.\", \"region\": \"Americas\", \"population\": 331900000, \"area\": 9833520, \"currency\": {\"code\": \"USD\", \"name\": \"United States dollar\", \"symbol\": \"$\"}, \"languages\": [\"English\"], \"callingCode\": \"+1\", \"flag\": \"🇺🇸\", \"timezones\": [\"UTC-05:00\", \"UTC-06:00\", \"… 2 more items\"]}",
});
const body: string = await res.text();
console.log(res.status, body);

import requests

res = requests.put(
    "https://api.testingapis.com/api/Countries/31",
    headers={
        "Content-Type": "application/json",
        "X-TestingApis-Key": "YOUR_API_KEY",
    },
    data="{\"name\": \"United States\", \"code\": \"US\", \"code3\": \"USA\", \"capital\": \"Washington, D.C.\", \"region\": \"Americas\", \"population\": 331900000, \"area\": 9833520, \"currency\": {\"code\": \"USD\", \"name\": \"United States dollar\", \"symbol\": \"$\"}, \"languages\": [\"English\"], \"callingCode\": \"+1\", \"flag\": \"🇺🇸\", \"timezones\": [\"UTC-05:00\", \"UTC-06:00\", \"… 2 more items\"]}",
)
print(res.status_code, res.text)

using System.Net.Http.Headers;

using var client = new HttpClient();
using var request = new HttpRequestMessage(HttpMethod.Put, "https://api.testingapis.com/api/Countries/31");
request.Headers.TryAddWithoutValidation("X-TestingApis-Key", "YOUR_API_KEY");
request.Content = new StringContent("{\"name\": \"United States\", \"code\": \"US\", \"code3\": \"USA\", \"capital\": \"Washington, D.C.\", \"region\": \"Americas\", \"population\": 331900000, \"area\": 9833520, \"currency\": {\"code\": \"USD\", \"name\": \"United States dollar\", \"symbol\": \"$\"}, \"languages\": [\"English\"], \"callingCode\": \"+1\", \"flag\": \"🇺🇸\", \"timezones\": [\"UTC-05:00\", \"UTC-06:00\", \"… 2 more items\"]}");
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/Countries/31"))
                .header("X-TestingApis-Key", "YOUR_API_KEY")
                .header("Content-Type", "application/json")
                .method("PUT", HttpRequest.BodyPublishers.ofString("{\"name\": \"United States\", \"code\": \"US\", \"code3\": \"USA\", \"capital\": \"Washington, D.C.\", \"region\": \"Americas\", \"population\": 331900000, \"area\": 9833520, \"currency\": {\"code\": \"USD\", \"name\": \"United States dollar\", \"symbol\": \"$\"}, \"languages\": [\"English\"], \"callingCode\": \"+1\", \"flag\": \"🇺🇸\", \"timezones\": [\"UTC-05:00\", \"UTC-06:00\", \"… 2 more items\"]}"))
                .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("{\"name\": \"United States\", \"code\": \"US\", \"code3\": \"USA\", \"capital\": \"Washington, D.C.\", \"region\": \"Americas\", \"population\": 331900000, \"area\": 9833520, \"currency\": {\"code\": \"USD\", \"name\": \"United States dollar\", \"symbol\": \"$\"}, \"languages\": [\"English\"], \"callingCode\": \"+1\", \"flag\": \"🇺🇸\", \"timezones\": [\"UTC-05:00\", \"UTC-06:00\", \"… 2 more items\"]}")
	req, err := http.NewRequest("PUT", "https://api.testingapis.com/api/Countries/31", 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))
}

PUThttps://api.testingapis.com/api/Countries/31

Path

idrequiredinteger (int32)