Skip to main content

How to...

Get a pact URL#

The same pact can be referenced by URL in multiple ways, and hence, there are multiple ways to get the URL for a pact in the UI.

By consumer version#

When a pact is published, the URL specifies the provider name, the consumer name and the consumer version. This same URL can be used to retrive the pact. To copy this URL into the clipboard, click on the VIEW PACT button from the Overview page, click on the vertical ... icon to the right of the Pact's title and select the Copy pact URL for {consumer} version {version} item.

By tag#

Locate the latest pact with the desired tag in the Overview page, click on the blue or grey pill icon that represents the application version tag, and select Copy pact URL. This menu can also be accessed from the Pact detail page.

Latest overall#

To get the URL of the overall latest pact for a consumer/provider, on the Overview page, click on the vertical ... icon, and select Copy latest pact URL.

Delete a single pact#

Locate the pact to be deleted in the Overview page. Click VIEW PACT. Click on the vertical ... icon to the right of the Pact's title, and select Delete pact for {consumer} version {version}.

Delete all pacts with a given tag#

Locate the latest pact with the desired tag in the Overview page, click on the blue or grey pill icon that represents the application version tag, and select Delete all pacts with tag {tag}. This item will only be visible if the user has the contract_data:bulk_delete permission for this integration.

Delete all pacts for a consumer/provider#

On the Overview page, click on the vertical ... icon in the top right of the Overview pane. Select Delete all pacts. This will delete all versions of the pact. It will keep the consumer and provider, and all other data related to them (webhooks, application versions, and tags).

Delete all pacts and associated objects for a consumer/provider#

On the Overview page, click on the vertical ... icon in the top right of the Overview pane. Select Delete integration. This will delete all data associated with this integration (applications, pacts, verifications, application versions, tags and webhooks) that are not associated with other integrations.

Delete verification results#

Locate the pact with the verification results that you want to delete in the Overview page and click VIEW PACT. Click on the vertical ... icon to the right of the Pact's title, and select Delete verification results for {provider} version {version}. If you cannot see the delete option, it is because you do not have the required permission for the provider application. Note that the verification results belong to the pact content, and other pact publications may share the same content, so deleting the verification results may affect the verification status of other pacts.

View the verification results for a specific consumer/provider version#

Select the Matrix tag for the desired integration. Locate the row with the desired consumer/provider version combination, and click on the link in the Pact published column.

Remove a tag from an application version#

This feature is not currently suppored directly though the UI, however, it can be achived through the API browser. Note that the tag belongs to the application version, not directly the pact, so removing a tag from an application version has the side effect of removing it from any other pacts associated with that application version.

  • Locate a pact with the desired tag in the Overview page.
  • Click on the blue or grey pill icon and select Copy tag URL.
  • Click on the API button in the top right of the screen.
  • Paste the tag URL into the location bar in the Explorer section and click Go.
  • In the Links section, click on the yellow ! icon under the NON-GET column.
  • Change the Method to DELETE, and click Make Request.