1. Home
  2. Upgrade Guides
  3. Bullhorn API Update – Star Syntax

Bullhorn API Update – Star Syntax

Beginning in August 2020 and likely continuing regularly until January 2021, Bullhorn began sending email notices to API users announcing the discontinuation of the “Star Syntax”. Matador does not use the Star Syntax in our production code and no action is necessary on your end.

The Notice

The following notice has been sent to API users whose code has used the star syntax recently:

We have identified that you will be impacted by an upcoming update to our API processes. We will be removing the ability to use the ‘*’ syntax in retrieving fields from API entities, effective January 1, 2021. To clarify, this capability will still be available for metadata queries, query parameters, and login; yet, will no longer be supported for retrieving values from specific entities.

This capability was originally offered as a convenience for developers during the prototyping phase, but was never intended to be utilized for production applications. Our operational teams have found that this feature generates unnecessary load on Bullhorn infrastructure, and has been linked to several production incidents.

To support this change, we are asking that you share this information with your web developers and ask that they update API requests to supply a specific list of fields on API requests rather than using fields=*. We recognize that this may take time to identify and update every usage of this feature, which is why we’re extending the support through the end of the year. In the meantime, our teams are happy to offer support and guidance throughout the process.

[…]

Action Required:
Update API calls to request a specific list of fields rather than using ‘fields=*’

Deadline:
January 1, 2021

Impact:
Effective January 1, 2021, any API calls using the ‘fields=.*’ syntax will return an error, causing correlated API processes to fail

If you have any questions or concerns, please reply here and I’ll be happy to assist. Additional reminders will be shared throughout the end of the year. In the meantime, I will place this ticket in a Confirmation status to ensure you’ve received the initial communication.

Does Matador Use the “Star Syntax”?

No.

Matador Jobs does not use the “Star Syntax” and therefore your site needs no changes to continue to function as expected.

Why did I get the warning email then?

There are two reasons you may have gotten the warning email from Bullhorn.

First is you had us do debugging on your site. On occasion, Matador developers granted access to your site to perform debugging related tasks may deploy a debugging tool which can utilize the star syntax. The star syntax is a fantastic tool to help solve issues, and was the purpose for the star syntax per Bullhorn:

This capability was originally offered as a convenience for developers during the prototyping phase

If we recently did debugging on your site, we may have used the star syntax for its intended purpose which likely triggered this warning, but once we were done with debugging, Matador Jobs will resume making API calls the right way without the star syntax.

The alternate reason you may have gotten this email is that another integration you are using may be using the star syntax. Matador Jobs, therefore, would not be the trigger for this email warning, and you will want to follow up with the developer of the other integrations to ensure a change is made before the deadline.

Matador Jobs is always being updated

One of the reasons you partner with Matador Software as a Matador Jobs user is that we take care of this stuff for you. As a Bullhorn Marketplace Partner, we were notified in July 2020, a full 45 days before email notices began going out to users about the discontinuation of the star syntax, of the upcoming change. If we needed to make a change to our software, we would’ve had the change out to you, our users, well before the first warning emails.

Keep your support licenses current and your license key registered on your site, and we will always handle the rest.

Updated on August 25, 2020

Was this article helpful?