jira issue link types¶
- Usage:
jira issue link types [flags]
List the issue link types configured in the active Jira site. Use it before creating links when you need the exact --type value and direction labels.
The command reads the linktypes cache when fresh. On a cache miss, stale entry, or --refresh, it fetches Jira's issue-link type metadata and updates the per-profile cache.
Cache¶
--refresh¶
Force a fetch even when the cache is fresh
--ttl-minutes <N>¶
Freshness window before automatic refresh
Default: 129600
Output fields¶
With --output json, the response envelope's data object carries these fields. Run jira agent schema for the full machine-readable schema.
| Field | Type | Description |
|---|---|---|
cache_empty |
boolean | |
cache_source_state |
string | Disposition observed before any fetch (never the derived empty state). |
cache_state |
string | Effective disposition after the read: fresh, stale, missing, malformed, refresh, or empty. |
count |
integer | |
fetched_at |
string (date-time) | |
from_cache |
boolean | |
link_types[].id |
string | |
link_types[].inward |
string | |
link_types[].name |
string | |
link_types[].outward |
string | |
link_types[].self |
string |
Examples¶
jira issue link types # (1)!
jira issue link types --refresh # (2)!
jira issue link types --output=json # (3)!
- Show the configured link types
- Force a refresh past the cache
- Return link types as JSON