jira cache clear¶
- Usage:
jira cache clear [resource] [flags]
Remove local cache files for the active profile. Use it when cached metadata is stale, malformed, or should be rebuilt on the next command.
With no argument, the command removes every cache file under the profile. With a resource name such as labels, projects, or boards, it removes only that cache file.
--dry-run reports what a live clear would remove without touching the files. A live clear requires --force in headless, agent, or --no-input mode; an interactive terminal proceeds without a prompt — the wipe is recoverable by re-priming.
Safety¶
--dry-run¶
Report what would be removed without removing anything
--force¶
Confirm the clear in headless / agent / --no-input mode
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 |
|---|---|---|
dry_run |
boolean | |
profile |
string | |
removed |
integer | boolean | File count on a whole-profile clear; whether the file existed on a single-resource clear. Under --dry-run, what a live clear would remove. |
resource |
string | Present when one resource was targeted; absent on a whole-profile clear. |
Examples¶
jira cache clear
jira cache clear boards # (1)!
jira cache clear --dry-run --output=json # (2)!
jira cache clear labels --force --output=json # (3)!
- Target a single cached resource
- Report what would be removed without removing anything
- Non-interactive (agent / script) clear