Clarify JIRA_BASE_URL is still required with JIRA_CLOUD_ID.

Document that the site URL powers browse links in the poller Webex summary while the cloud gateway handles REST API calls.

Co-authored-by: Cursor <cursoragent@cursor.com>
This commit is contained in:
jmcqueen 2026-08-21 09:25:01 -04:00
parent 9282e9cd0d
commit 65f11c9da8

View file

@ -318,11 +318,14 @@ WEBEX_HOST_LICENSE_ID=
# ----------------------------------------------------------------------------- # -----------------------------------------------------------------------------
# Jira (required for /jira* commands) # Jira (required for /jira* commands)
# Use JIRA_CLOUD_ID for service accounts / new Atlassian API gateway endpoints: # JIRA_CLOUD_ID — service account / Atlassian Cloud API gateway (preferred):
# JIRA_CLOUD_ID=<uuid-from-atlassian> # JIRA_CLOUD_ID=<uuid-from-atlassian>
# (constructs https://api.atlassian.com/ex/jira/<id>/rest/api/3 ...) # (constructs https://api.atlassian.com/ex/jira/<id>/rest/api/3 ...)
# Otherwise fall back to classic site base: # JIRA_BASE_URL — your Jira site hostname (https://your-org.atlassian.net).
# JIRA_BASE_URL=https://your-org.atlassian.net # Still required when using JIRA_CLOUD_ID: REST calls use the cloud gateway,
# but human browse links (e.g. poller Webex summary ticket keys) use
# JIRA_BASE_URL/browse/{KEY}. If unset, API may work but links won't click.
# If JIRA_CLOUD_ID is unset, JIRA_BASE_URL is also used for REST API calls.
# ----------------------------------------------------------------------------- # -----------------------------------------------------------------------------
JIRA_CLOUD_ID= JIRA_CLOUD_ID=
JIRA_BASE_URL=https://your-org.atlassian.net JIRA_BASE_URL=https://your-org.atlassian.net
@ -351,6 +354,8 @@ JIRA_MAX_RESULTS=30
# Webex space roomId to post the per-poll "N new tickets" summary to. # Webex space roomId to post the per-poll "N new tickets" summary to.
# Poller stays DISABLED (cron never registered) if unset — safe default # Poller stays DISABLED (cron never registered) if unset — safe default
# for dev instances that share the same Jira credentials. # for dev instances that share the same Jira credentials.
# Summary ticket keys link to JIRA_BASE_URL/browse/{key} — keep JIRA_BASE_URL
# set even when JIRA_CLOUD_ID handles API access.
# #
# JIRA_POLLER_PRIME_ON_START # JIRA_POLLER_PRIME_ON_START
# One-shot backlog-prime toggle. Set to `true` for a SINGLE deploy to # One-shot backlog-prime toggle. Set to `true` for a SINGLE deploy to