Setting configuration properties

Automation for Jira includes a number of configuration properties that let you check or change the default values related to various actions, conditions, and other items.

You need to be a Jira administrator to view or change the configuration properties.

Checking the current value

To check the property’s current value:

curl -u <user>:<password>  http://<JIRA_BASE_URL>/rest/cb-automation/1/configuration/property/<PROPERTY_KEY>

Changing the value

To change the value:

curl -u <user>:<password> -X PUT -H 'Content-type: application/json'  --data '{"key":"<PROPERTY_KEY>","value":"<VALUE>"}' http://<JIRA_BASE_URL>/rest/cb-automation/1/configuration/property/

For example:

curl -u admin:admin -X PUT -H 'Content-type: application/json'  --data '{"key":"outgoing.webhook.timeout.ms","value":"50000"}' http://jira.atlassian.com:8080/jira/rest/cb-automation/1/configuration/property/

For Jira running on Windows server, you can use Invoke-webrequest. The script below was tested on Windows Server 2016:

$user = 'YOUR_USER_ADMIN'
$pass = 'PASSWORD'
 
$pair = "$($user):$($pass)"
 
$encodedCreds = [System.Convert]::ToBase64String([System.Text.Encoding]::ASCII.GetBytes($pair))
 
$basicAuthValue = "Basic $encodedCreds"
 
$Headers = @{
    Authorization = $basicAuthValue
}
 
$Uri = 'http://YOURJIRABASEURL/rest/cb-automation/1/configuration/property/bulk'
$Form = @{
    "ms.teams.notification.action.url.prefix"="https://"
}
Invoke-WebRequest -Uri $Uri -Method Put -Body ($Form|ConvertTo-Json) -ContentType "application/json" -Headers $Headers

List of properties

Here’s a list of properties that you might find useful. We’ll keep updating it.

CategoryProperty keyData typeDefault valueDescription

Project Admin permissions

permissions.project.admin.allow

Boolean

true

Specifies whether project admins can manage automation rules.

permissions.project.admin.groups

String

null

Lets you limit project admins who can manage automation rules to specific groups only. The value contains a CSV list of groups.

Service limits

max.issues.per.search

Long

1000

Limits the number of issues returned by the JQL search.

max.processing.time.per.day

Long

3600

Specifies how long the same rule is allowed to run per day. The value is in seconds.

rule.rate.per.five.second

Long

2

Specifies how many times the same rule can be executed during a 5-second time window.

max.rules.per.hour

Long

5000

Specifies the maximum number of times the same rule can be executed per hour.

max.queued.items.per.rule

Long

25000

Specifies the maximum number of executions that can be queued for the same rule.

max.queued.items

Long

100000

Specifies the maximum number of items in the automation queue.

aggressive.timeout.threshold

Long

30000

Specifies the maximum rule execution time. After this time, the rule is reported as causing timeouts. The value is in milliseconds.

short.scheduled.interval.issue.limit

Long

1000

Limits the number of issues returned by the JQL search in the scheduled trigger.

branch.rule.immediate.priority.item.limit

Long

10

Specifies the maximum number of branch executions with immediate priority.

audit.log.retention.period.days

Long

90

Specifies how long audit log entries are kept for a rule. The value is in days.

Action and condition specific

outgoing.webhook.timeout.ms

Long

30000

HTTP timeout for outgoing webhooks. The value is in milliseconds.

user.condition.get.users.limit

Integer

50

Specifies the maximum number of users that can be retrieved from a single role in the User condition.

slack.notification.action.url.prefix

URL

https://hooks.slack.com/

Specifies the URL prefix that a webhook should start with in the Send Slack message action.

ms.teams.notification.action.url.prefix

URL

https://outlook.office.com/webhook/

Specifies the URL prefix that a webhook should start with in the Send Microsoft Teams message action.

Last modified on Apr 21, 2021

Was this helpful?

Yes
No
Provide feedback about this article
Powered by Confluence and Scroll Viewport.