Joust Development Highlights & Support Notes

The information in this article is the intellectual property of xMatters and is intended only for use with xMatters products by xMatters customers and their employees. Further, this intellectual property is proprietary and must not be reused or resold.


We're hard at work on our next quarterly release, Joust, which will be rolling out in the Oct/Nov 2020 time frame. Please follow this article and its comments to receive updates throughout the quarter about new features and functionality that we're working on for the Joust release.

Customers interested in previewing new features before they're released can opt into our Early Access Program (EAP), which delivers new features into non-production environments as they're rolled off the assembly line.

We'll also use this document to capture highlights of additions and updates to our mobile platforms and the xMatters REST API.

Deployment Details

For more information on how features in this article work, click the online help links embedded in each topic. As with any of our Community articles, you can click any image or animated GIF to see a larger version.

Support Notes

For a list of additional changes made in each deployment that are not covered in the Development Highlights, see the On-Demand support notes included below each highlight. While most features will be added to production environments as part of our quarterly releases, the support notes typically describe fixes, which can sometimes affect product behavior.

July 27-31, 2020

Adaptive Incident Management

Availability: Joust Quarterly Release & Early Access Program

We're adding adaptive incident management to the already amazing list of offerings in our world-class digital service availability platform. We'll be introducing this whole new approach to incident response and automation in just a few short weeks, but we're so excited that we just had to show it off now!

For a detailed overview of the xMatters incident model - and how you can opt-in to early access - head on over to our feature announcement article, Introducing Adaptive Incident Management.


Upgrade your plan online

Availability: Now in xMatters

If you're currently using a trial or free version of xMatters, and you're located in the United States, you can now upgrade to a paid plan online.

When you click Upgrade in the top right corner of your screen, you'll be taken to a page with your upgrade options. At this time, you can upgrade to our Base or Starter plan for a one year contract term, paid annually:


If you need to purchase a very large number of user licenses, or you want to upgrade to the Advanced plan, then you'll need to talk to one of our friendly Sales representatives.

For instructions on how to upgrade online, and for a great list of frequently asked questions, see Upgrading your plan.

New GET/sites query parameters

Availability: Now in the xMatters REST API

Wish there were more criteria you could use to look up sites programmatically with the xMatters REST API? How about being able to sort the sites that are returned? Then you'll be happy to hear about the following new functionality we've added to GET/ sites:

  • More specific searches – When you search with multiple search terms, you can use operand to narrow your results to just sites that contain all the search terms in their name or description. For example, GET /sites?search=term1 term2&operand=AND
  • Search by specific fields – You can use the fields query parameter in combination with search to find sites with a particular value in their NAME or ADDRESS. For example, GET /sites?search=term&fields=NAME
  • Find sites by country – Use the country query parameter to find sites within a specific county by providing the country's full name or its country code. For example: GET /sites?country=Canada
  • Find sites by status – The status query parameter lets you find sites that are ACTIVE or INACTIVE. For example: GET /sites?status=ACTIVE
  • Find sites that are geocoded (or not) - When the geocoded query parameter is set to true, xMatters returns sites whose full longitude and latitude coordinates are set; if set to false, you'll get back the sites with missing or partial coordinates. For example: GET /sites?geocoded=true
  • Sort sites by name, address, status, geocoded, or country – To sort the sites that are returned, specify which value to sortBy, and whether to sort in ascending or descending order. For example: GET /sites?sortBy=ADDRESS&sortOrder=ASCENDING

New GET /groups query parameters

Availability: Now in the xMatters REST API

The GET /groups endpoint includes two new query parameters you can use to sort the groups that are returned, or to find groups based on their status:

  • Sort groups by name or status – You can specify whether the groups that are returned are sorted by their NAME or STATUS, in ascending or descending order. For example: GET /groups?sortBy=NAME&sortOrder=ASCENDING
  • Find groups by status – The status query parameter lets you find the ACTIVE or INACTIVE groups in your system. For example: GET /groups?status=ACTIVE

New GET /people query parameters

Availability: Now in the xMatters REST API

Looking for users that aren't in any groups? What about users that are in a specific group, or groups? If so, check out what you can do with these new query parameters for GET /people:

  • Find users that belong to a group, or groups – Use the groups query parameter to specify a comma-separated list of group target names or UUIDs. If you specify multiple groups, xMatters returns the users who are members of any (not all) of the groups. For example: GET /people?groups=DevOps,25070811-5b97-4e39-887c-a81639598864
  • Find users that are (or aren't) in any groups – You can use the Groups.exists query parameter to identify the users that are members of at least one group (true), or users that aren't members of any groups (false). For example: GET /people?groups.exists=false

Support notes (week of July 27-31)

xMatters Internal Reference No. Summary
Groups - shift rotation: Corrected an issue preventing shifts from rotating as scheduled.
COR-28898 Historical On Call report export (usability fix): Modified the report so the exported "User ID" field displays the user's User ID instead of their Web Login ID.
User export: Fixed an issue that could cause the export to time out when dealing with a large number of items in a custom field.
COR-28857 Shared Dashboards (usability fix): Corrected an issue to ensure only the appropriate users can make changes to shared dashboards.
Messaging forms (cosmetic fix): Adjusted the size of the Text input field to match other field sizes.
COR-28833 Messaging forms - Recipients window (cosmetic fix): Fixed an issue that caused a misalignment of the recipient type drop-down menu when the window was expanded.
COR-28825 Workflows - Responses (cosmetic fix): Adjusted spacing in the Options column to provide more consistent design.
COR-28824 Workflows - Subscription Forms (cosmetic fix):  Modified the Available Properties column so properties with long names are truncated.
Subscriptions: Corrected an issue that prevented users from changing the owner of a subscription.
All Events Report: Fixed an issue causing the export to timeout when events did not have initiators.
COR-28511 Flow Designer - custom steps: Ensured the proper error message appears to users when they save a custom step without a name.

July 20-24, 2020

xMatters Agent: Local store-and-forward

Availability: Now in xMatters

xMatters Agent 1.6 provides some extra relief when there's a short-term event flood or connectivity issue. Instead of immediately sending inbound requests to xMatters, the agent will queue the requests and forward them only when the connection is established and secure. 

This change has several immediate benefits: 

  • Your integrations will be much more resilient when encountering network outages or event floods. 
  • If you're submitting too many requests too quickly, the agent will queue the requests that return code 429 (meaning you've exceeded the permitted rate) and resubmit them after a short wait. 
  • You'll be able to conduct expanded troubleshooting if your integrations have problems connecting.

While the queue does not persist if you shut down the agent, it does improve the reliability of the agent when sending requests to xMatters from third-party applications. And the best part is that there's no configuration change required — this feature will be automatically available as soon as you update.

Users page: Filter by site and temporary absences

Availability: Now in xMatters

The Users page includes two new filters for finding users based on the site they're located at, and whether they're currently absent from a group:

  • Site - Easily find the users at your site, or search for a different site:


  • Absent - See the users that are absent with a replacement, absent without a replacement, or those that don't currently have any absences:


All Events report: Filter by source

Availability: Now in xMatters

The All Events report now includes a Source filter that you can use to find all the events that came from a specific workflow or integration:


Support notes (week of July 20-24)

xMatters Internal Reference No. Summary
Role based permissions: Fixed a permission issue involving support users that was introduced with the Indy release.
All Events report: Enhanced performance for the All Events report when attempting to view a high number of recipients.
All Events report - User Delivery tab: Corrected an issue where events were displayed with an incorrect delivery status.
COR-28609 xMatters Mobile App (Android): Fixed an issue where event responses weren't fully collapsing for Android 10 users.
COR-29622 Workflows - importing: Fixed an issue where some imported workflows didn't include correct steps and triggers on the canvas.
User export - custom fields: Corrected an issue that caused information from custom fields to display in the wrong columns.
API Keys (usability fix): Fixed an issue that caused some browsers to show a page loading spinner on the API Keys page when the user had no existing API Keys.
Web user interface - login screen: Corrected an issue where some users logging in using SAML were unable to access the Web user interface.
COR-28352 Messaging menu - enabled workflows: Fixed an issue that prevented newly enabled workflows from appearing in the Messaging menu.

July 13-17, 2020

Mobile: Android 2.25

Availability: Now from the Google Play store

With this new version of the xMatters Android app, you can now add comments to events (previously, you could only view them). Here's a peek of what the new functionality look like in the app:


Support notes (week of July 13-17)

xMatters Internal Reference No. Summary
Users page (usability fix): Fixed an issue that prevented supervisors from viewing users in the Users page.
xMatters REST API - GET /audits: Corrected an issue that caused the request to time out when dealing with a large number of targeted recipients.
COR-28056 Android mobile app (usability fixes): Adjusted the mobile app to provide a smoother and more consistent experience for users.
COR-26907 Android mobile app - Workload Assignment: Corrected an issue that prevented the hierarchy field from properly displaying options.
 COR-28294 Flow Designer (cosmetic fixes): Updated the layout and positioning for some elements to prevent icons and messages shifting outside their intended locations.
 COR-28250 Flow Designer - Activity stream: Provided French translations for all items in the Request Status of the Activity stream.
 COR-27730 Groups - shifts (cosmetic fix): Corrected an issue that cause an error message to remain static on the page instead of moving with its field when the page is scrolled.
COR-25528 Groups - add users (cosmetic fix): Updated the icons for users to ensure consistent icon usage between the Members and Supervisors tabs.

About the early access delivery process

Customers can choose to opt their non-production environments into an Early Access Program (EAP) to see new functionality before it's released. If you're considering signing up for the early access program, there are a couple of important things to know:

  • Enrollment in EAP can be turned on any time through a support request.
  • Exiting EAP can only be done on quarterly boundaries (you cannot opt in and out between quarterly releases).

For full details, refer to the official On-Demand Deployment Process & Early Access article.

Have more questions? Submit a request


  • 0
    Karla Poplawski

    Highlights and support notes added for week of July 20-24, 2020:

    Updates include:

    • xMatters Agent: Local store-and-forward
    • Users page: Filter by site and temporary absences
    • All Events report: Filter by source
    Edited by Karla Poplawski
  • 0
    Karla Poplawski

    Highlights and support notes added for week of July 27-31, 2020:

    Updates include:

    • Adaptive incident management
    • Upgrade your plan online
    • xMatters REST API: New query parameters for GET /sites, GET/ groups, and GET/people
Article is closed for comments.
Powered by Zendesk