Golive Cloud Golive Data Center
Auto Light Dark
Auto Light Dark
Golive Cloud Golive Data Center
Breadcrumbs

Update an Environment Attribute from a Jira Work Item

In this guide, you'll learn how to use Jira Automation and the Golive REST API to update an Environment attribute with a value from a Jira work item.

This is useful when a Jira work item represents a planned change and you want Golive to reflect the new Environment state only after the change has been completed.

In this example, an Environment Change work item is used to perform a data refresh:

  • The target Environment(s) are selected in the Environments field.

  • The new dataset is entered in a Jira custom field named Dataset.

  • When the work item transitions to Done, Jira Automation updates the Dataset attribute of each selected Golive Environment.



Requirements

  • Golive Cloud installed on Jira Cloud.

  • Jira Administrator permission to create and modify Jira Automation flows.

  • A Golive Environment custom field, such as Environments, available on the relevant work type.

  • A Jira custom field named Dataset.

  • A Golive Environment attribute named Dataset.

  • A Golive API Token.

Info

The Jira custom field and Golive Environment attribute do not need to have the same name. In this example, both are named Dataset to make the mapping easier to understand.



Configuration Overview

In this example, we create a Jira Automation flow that:

  1. Triggers when an Environment Change moves from In Progress to Done.

  2. Checks that both the Environments and Dataset fields are populated.

  3. Retrieves the Golive Environments selected on the work item.

  4. Loops through the selected Environments.

  5. Calls the Golive REST API to update the Dataset attribute of each Environment.



Step 1: Configure the Environment Change Work Item

Add a Dataset custom field to the Environment Change work type.

In this example:

  • Environments: eCommerce Integration 1

  • Dataset: Prod snapshot - 2026-08-31

The Environments field identifies which Golive Environment should be updated, while Dataset contains the new value that will be pushed to Golive when the change is completed.

image-20260917-221014.png
Environment Change with a Dataset field

Make sure that a Dataset Environment attribute also exists in Golive.

image-20260917-221217.png
Golive Environment with a Dataset attribute



Step 2: Create a Jira Automation rule

Create a new Jira Automation rule with the following configuration:

image-20260917-220638.png
Jira Automation Configuration


Trigger: Work item transitioned

This flow is triggered when the work item transitions from In Progress to Done.

image-20260917-221345.png

JQL condition

project = EM
AND type = "Environment Change"
AND Dataset IS NOT EMPTY
AND Environments IS NOT EMPTY

Adjust the Jira space key, work type, and field names to match your configuration.


Action: Get Golive Environments by id

This action retrieves all Environments from the Environments custom field.

image-20260917-222120.png

Environment Id(s)

{{issue.customfield_XXXXX}}

Replace customfield_XXXXX with the ID of your Golive Environments custom field.

The retrieved Environments are available to subsequent automation steps through:

{{fetchedGoliveEnvsbyidList}}

This action supports one or multiple Environments selected in the Jira work item.


Branch: Advanced branching

Add a Branch with Advanced branching. The actions inside this branch will be executed once for each Golive Environment selected on the work item.

image-20260917-222308.png

Variable name

environment

Smart value

{{fetchedGoliveEnvsbyidList}}



Action: Send web request

The PUT /api/environment/{id} endpoint updates the specified Golive Environment. Only the attribute included in the request needs to be provided.

image-20260917-222659.png

Web request URL

https://golive.apwide.net/api/environment/{{environment.id}}

Custom data

{
  "attributes": {
    "Dataset": {{issue.customfield_YYYYY.asJsonString}}
  }
}

Replace customfield_YYYYY with the ID of your Jira Dataset custom field.

Using asJsonString ensures that the Jira field value is correctly encoded in the JSON request.

Headers




Test your Automation

Create an Environment Change with:

Environments: eCommerce Integration 1
Dataset: Prod snapshot - 2026-08-31

Move the work item to In Progress, then transition it to Done.

The Jira Automation flow runs and updates the selected Golive Environment.

The Environment should now display:

Dataset: Prod snapshot - 2026-08-31

The same approach can be used to synchronize other Jira values with Golive Environment attributes, such as database versions, configuration versions, locations, owners, or other information describing the current state of an Environment.



Need Assistance?

For support with integrating Golive and Jira Automation, reach out to our Customer Portal.