Getint Instance URL

The Getint instance URL is a unique identifier for a Getint installation. It is used to establish secure connections between Jira instances, validate licenses, and expose important instance metadata. This article explains what the Getint instance URL is, where to find it, and how it’s used in cross-instance configurations.

What Is the Getint Instance URL?

The Getint instance URL uniquely represents a Getint instance running within a Jira environment. It allows Getint to:

• Identify another Getint instance on the “other side” of a connection.

• Validate licensing without querying Jira directly.

• Exchange instance-level metadata, such as version and data residency.

From now on, the Getint instance URL is the single source of truth for instance identification and license checks.

Obtain Your Getint Instance URL

Each Jira instance running Getint has its own Getint instance URL.

To find it:

1. Open the Getint app in your Jira instance.

1. Navigate to Settings, and open the General tab. Your Getint instance URL is displayed there.

This URL is generated automatically and is specific to that Getint installation.

Adding the Getint Instance URL to the Connection

When setting up a connection between two Jira instances, you must retrieve the URL from the counterpart (the Jira instance you are connecting to).

You do not need to provide the Getint instance URL in the connection that is running the integration.

The only exception is when a single Getint instance connects to two different Jira instances, for example, one on the left and another on the right. In this scenario, each connected Jira instance must have its corresponding Getint instance URL specified in the connection configuration.

1. Go to the connection configuration (Workflows > Connections), locate the Jira connection you want to update, and click the 3-dot button below “Actions.”

1. Click on Edit to modify the connection.

1. Specify the Getint instance URL of the partner (Getint instance on the other side), and hit the Update button.

1. Now test your integration. This time, you shouldn’t experience any Jira licensing errors.

Once updated, the two Getint connections are linked, allowing for secure and accurate cross-instance communication.

Licensing Behavior Using the Getint Instance URL

With Forge, licensing is now handled at the Getint level rather than through Jira directly.

• If Jira 2 is licensed, license validation is performed by querying the Getint instance identified by the provided instance URL.

• Getint no longer asks Jira whether a license exists.

• Instead, Getint asks the other Getint instance: “Is there an explicit license associated with this instance URL?”

Summary

• Every Getint installation has a unique Getint instance URL.

• The instance URL is available in the Getint app > Settings > General.

• No need to specify an ID for your local Jira instance (the Jira that is running the integration), regardless of whether it is configured as the left or the right side of the connection. Just focus on grabbing the Getint URL for the counterpart instance.

• License validation is now performed via Getint using the instance URL, not Jira.

• Additional metadata, such as version and data residency, is tied to the instance URL.

Using the Getint instance URL ensures clear identification, accurate license validation, and a scalable foundation for cross-instance integrations.

Need Assistance?

If you encounter any issues retrieving your Getint instance URL, configuring the connection, or validating licensing, please contact our Support Team for assistance.

Start your integration journey. Schedule a free consultation with our Getint Integration Expert today!