New API endpoints for deployments

By Jared Scholz | Posted Dec 6, 2024 | 3 min. (464 words)

This enhancement is part of Raygun’s 12 Days of Christmas 2024. Over the next few weeks, we’ll share daily updates on bug fixes and feature improvements inspired by feedback from you, our customers. These are the small but impactful changes you’ve asked for, designed to make Raygun faster and easier to use. Check back tomorrow for the next update and see how we’re leveling up your experience one day at a time!

Our special thanks to Andrew from the U.K. who suggested this great idea!

What is it?

We’ve just rolled out three new Raygun API endpoints for deployments! These let you grab the latest deployment and fetch error groups tied to a specific deployment. For the error group endpoints, you can filter by error status—such as new, still occurring, or regressed errors—to get exactly what you need.

Where is it and how does it work?

You can find these new endpoints in our API specification here. To use these three endpoints, you’ll need your personal access token and application identifier.

To retrieve your latest deployment from Raygun, use the following endpoint:

GET https://api.raygun.com/v3/applications/{application-identifier}/deployments/latest

You can use the following endpoint to get all the error groups for the latest deployment:

GET https://api.raygun.com/v3/applications/{application-identifier}/deployments/latest/error-groups

If you have its deployment identifier (returned when a deployment is created or via the list deployments endpoint), you can retrieve all the error groups for a specific deployment:

GET https://api.raygun.com/v3/applications/{application-identifier}/deployments/{deployment-identifier}/error-groups

For the above two endpoints, you can append an optional filter parameter to the request that will apply one of the following filters to the deployment’s error groups.

?filter=state eq new
?filter=state eq stillOccurring
?filter=state eq regressed

What is the benefit?

With these new API endpoints, you’ll never have to worry about missing critical bugs in your latest release. Grab deployment data instantly and track error groups tied to specific releases without the hassle of manual checks. Filter errors by status—new, ongoing, or regressed—so you can focus on what matters most. Combine this with pushing data to 3rd party tools like Teams or Slack, and you’ll catch issues early, respond faster, and keep your releases running smoothly.