Stable v3 API and client integrations

Today's a good day! We just published new stable versions of all of our client integrations. Almost all of the clients are now running on the v3 API. API v3 where released in beta more than a year ago. As of last week, the new version moved into stable as well. An updated overview of our NuGet packages is available to help you get an overview of the clients.

Over the years, we've gained a lot of experiences and feedback from our v2 API. All of the input have been piped into v3, which is available as a Swagger endpoint. One of the benefits of moving to Swagger is, that it is now extremely easy to integrate with I don't have a lot of good memories from the days of SOAP and WSDL files, but one thing worked great: the ability to generate strongly typed clients for any programming language using a WSDL file. The same feature is now available using our Swagger endpoint and a client generator like AutoRest (built into VS2017):

Generate REST API clients in VS2017

Actually you don't even need to generate a client yourself. Our Elmah.Io.Client package has been updated to use the new API. Most parts of the client is auto-generated using AutoRest as well.

What changed?

Here are the highlights of the new API:

  • API keys introduced to improve security (more about this later)
  • Available as a Swagger endpoint.
  • New endpoints for creating and fetching logs.
  • New endpoints for creating and fetching deployments.
  • Request throttling to make sure that you don't use up all of your included messages within a few minutes.
  • API available on (rather than, which makes it possible for us to scale and modify the API without touching the website.

The message endpoints used to log messages to looks almost identical to v2.

How to upgrade?

The big change when moving to API v3 is the introduction of API keys. In API v2, anyone with a log ID (the GUID representing your log), would be able to extract content from that log. With API keys, you now have the option to generate API keys for different clients, revoke a key if you suspect that it has been compromised and more.

When upgrading your* client packages, you will need to add your API key to your configuration (Where is my API key). How the API key should be added, depends on your integration. With ASP.NET Core, you will see a compile errors after upgrade, since Elmah.Io.AspNetCore and Elmah.Io.Extensions.Logging are configured through code. When upgrading the Elmah.Io package (ASP.NET / MVC / Web API), you will need to add the new apiKey attribute to your web.config:

    <errorLog type="Elmah.Io.ErrorLog, Elmah.Io" apiKey="API_KEY" logId="LOG_ID" />

If you are dependant of someone allowing outbound traffic from your webservers, you will need to ask for access to when upgrading to v3.

For more info on installing the different client integrations, check the installation guides on The documentation will also help you upgrade the parts of the update that isn't backwards compatible. If you have a question, please don't hesitate to reach out to our support. Error logging and Uptime Monitoring for your web apps

This blog post is brought to you by is error logging, uptime monitoring, deployment tracking, and service heartbeats for your .NET and JavaScript applications. Stop relying on your users to notify you when something is wrong or dig through hundreds of megabytes of log files spread across servers. With, we store all of your log messages, notify you through popular channels like email, Slack, and Microsoft Teams, and help you fix errors fast.

See how we can help you monitor your website for crashes Monitor your website