jira cache refresh¶
- Usage:
jira cache refresh [resource...] [flags]
Refresh cached Jira metadata for the active profile. With no arguments, it checks every registered resource; with resource names, it checks only those.
Fresh resources are skipped unless --force is set. Resources are refreshed with bounded concurrency, and a failure for one resource is returned in the structured envelope without discarding successful refreshes.
Pagination¶
--unbounded¶
For boards, walk every page (disables the default cap)
Safety¶
--dry-run¶
Report which resources are stale without refetching or writing (never contacts Jira)
Cache¶
--force¶
Refetch every resource regardless of freshness
--ttl-minutes <N>¶
Freshness window override for all resources (0 = per-resource default)
Default: 0
Execution¶
-p --parallelism <N>¶
Maximum concurrent requests (1-16)
Default: 1
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 |
|---|---|---|
failed |
integer | |
results[].data |
object | Present when ok is true; the command's single-target data shape. |
results[].error |
object | Fields: code, field, flag, hint, http_status, message, … |
results[].key |
string | |
results[].ok |
boolean | |
succeeded |
integer |
Examples¶
jira cache refresh
jira cache refresh --force # (1)!
jira cache refresh boards labels # (2)!
jira cache refresh --force --output=json # (3)!
- Refresh everything, ignoring freshness
- Limit the refresh to named resources
- Refresh every resource and keep the result parseable