Tips and Tricks

Leveraging the HTTP Header Location

There's more to RESTful services than just using the HTTP verbs. You should also be leveraging the Location header and status code, for example.

When REST was proposed as a way of leveraging the HTTP protocol, the idea was to do more than just take advantage of the HTTP verbs GET, POST, DELETE and so on -- the goal was to take advantage of all the features of HTTP. If you're creating RESTful services, you should be following that paradigm.

For example, HTTP headers can include a status code that indicates a new resource was created and a URL that points to that resource. In a RESTful application, if you add a new customer, then you should be sending the client a message with headers that include the HTTP Created status code and a Location set to the URL where the new customer could be retrieved. The code to create those headers would look something like this:

Public Function CreateCustomer(cust As Customer) As ActionResult
  Dim newCust As Customer
  '... code to add a customer with Id of 'A123'... 
  Response.StatusCode = HttpStatusCode.Created
  Dim hlpr As New UrlHelper(ControllerContext.RequestContext)
    "Location", hlpr.Action("GetCustomer", "Customer", New With {.id = "A123"}))     
End Function

The client can now check the HTTP status code and, when the client discovers that Created status, use the Location header to find the new resource. It's the RESTful way to do it.

About the Author

Peter Vogel is a system architect and principal in PH&V Information Services. PH&V provides full-stack consulting from UX design through object modeling to database design. Peter tweets about his VSM columns with the hashtag #vogelarticles. His blog posts on user experience design can be found at

comments powered by Disqus


  • Top 3 Blazor Extensions for Visual Studio Code

    Some developers prefer to create applications with Microsoft's open-source Blazor tooling from within the open-source, cross-platform Visual Studio Code editor. Here are the top tools in the VS Code Marketplace for those folk, as measured by the number of installations.

  • How to Invert a Machine Learning Matrix Using C#

    VSM Senior Technical Editor Dr. James McCaffrey, of Microsoft Research, explains why inverting a matrix -- one of the more common tasks in data science and machine learning -- is difficult and presents code that you can use as-is, or as a starting point for custom matrix inversion scenarios.

  • Microsoft Engineer: 'It's Time to Move OData to .NET 5'

    Microsoft engineer Sam Xu says "it’s time to move OData to .NET 5" and in a new blog post he shows how to do just that.

  • Microsoft Goes Virtual with Developer Education in Face of COVID-19

    Like many organizations that host developer educational events, Microsoft has gone virtual amid shelter-in-place directives and a surge in remote work stemming from the COVID-19 pandemic.

  • Microsoft Enhances Low-Code Power Apps

    Microsoft's nod to the low-code movement, Power Apps, has been enhanced with a bevy of new features, including mixed reality, canvas/model support in a new mobile app, UX improvements and more.

.NET Insight

Sign up for our newsletter.

Terms and Privacy Policy consent

I agree to this site's Privacy Policy.

Upcoming Events