201 Created का मतलब है कि रिक्वेस्ट पूरी हो गई है और उससे एक या ज़्यादा नए रिसोर्स बने हैं। API आम तौर पर किसी कलेक्शन पर POST या किसी नए URL पर PUT के बाद इसे लौटाते हैं। मुख्य नया रिसोर्स Location हेडर से पहचाना जाता है, और अगर Location नहीं है, तो रिक्वेस्ट URL से।
बॉडी में आम तौर पर नए रिसोर्स का विवरण या उसका लिंक होता है। रिस्पॉन्स में मौजूद ETag जैसे वैलिडेटर नए बने रिप्रेज़ेंटेशन पर लागू होते हैं, इसलिए क्लाइंट बाद की कंडीशनल रिक्वेस्ट में उनका इस्तेमाल कर सकता है।
3xx रिस्पॉन्स के उलट, 201 में आया Location हेडर रीडायरेक्ट नहीं है। ब्राउज़र और HTTP क्लाइंट उसे अपने आप फ़ॉलो नहीं करते।
उदाहरण रिस्पॉन्स
HTTP/1.1 201 Created
Date: Fri, 06 Nov 2026 10:15:32 GMT
Location: https://api.example.com/v1/orders/8412
Content-Type: application/json
Content-Length: 30
{"id":8412,"status":"pending"}SEO और रीडायरेक्ट जांच
201 API और फ़ॉर्म हैंडलर के लिए है, इंडेक्स होने वाले पेजों के लिए नहीं। जिन क्रॉलर को यह मिलता है, वे इसे सफलता मानते हैं, लेकिन किसी पब्लिक पेज URL को 200 लौटाना चाहिए। ब्राउज़र में फ़ॉर्म सबमिट होने के बाद आम तरीका यह है कि इसकी जगह 303 See Other से जवाब दिया जाए, ताकि नतीजे वाला पेज रीलोड करने पर फ़ॉर्म दोबारा सबमिट न हो।
आम वजहें और इस्तेमाल
- किसी REST API ने एक रिकॉर्ड बनाया (
POST /orders) और उसका URLLocationमें लौटाया। - कोई फ़ाइल
PUTसे ऐसे URL पर अपलोड की गई जो पहले मौजूद नहीं था। - रीडायरेक्ट जांच में ऐसे URL के लिए 201 दिखता है जिसे आप पेज समझ रहे थे: या तो वह एंडपॉइंट API है, या जांच POST से की गई। एडवांस सेटिंग्स में HTTP मेथड देखें।