Browse documentation
Docs/Admin Toolkit/Permissions, data and limits

Permissions, data and limits

What the app can access, what it stores, and troubleshooting.

Permissions the app requests

ScopeWhy it is needed
read:jira-work, write:jira-workRead configuration and issues; reassign issues and apply changes.
read:project:jira, manage:jira-projectRead and manage projects, leads, components and archiving.
manage:jira-configurationRead and modify fields, schemes, contexts and filters. This is the core of most tools.
read:jira-userResolve users and groups for the user tools.
read:board-scope:jira-software, read:board-scope.admin:jira-softwareRead boards, so offboarding can report board ownership.
storage:appStore job progress, results and tool settings.
report:personal-dataReport to Atlassian the account IDs held in job results, so a closed account can be erased from them.

The app declares no external network access at all — there is no allowed-host list in its manifest, because it never calls anything outside the Atlassian APIs it is already running against. The PDF and CSV files are generated in your browser, not by a service.

It is available in nine locales: English (US and UK), Portuguese (Brazil and Portugal), Spanish, French, German, Italian and Japanese.

What the app stores

  • Job progress and results for the operations you run: assessments, merger analyses and generated CSV rows, offboarding scans, cleanup scans. Results are kept so you can review a completed run.
  • Tool settings, such as the target project and issue type used when a tool creates an issue.

Results contain user names, account IDs and group names when that is what you asked the tool to analyse — a permission audit is a report about people. It is all in the app's own key-value storage inside your Atlassian site; there is no database and nothing leaves.

There is no audit log, and no automatic expiry
This app keeps no record of what you did with it — the tools report their results and that is the whole of it. Nor is there a retention clock: a completed job's results sit in storage until you press Start Over in that tool, run it again, or uninstall the app. If a scan named people you would rather not keep on file, reset the tool when you are done with the results. The one thing that removes data on its own is the daily closed-account sweep below.

Closed accounts, and uninstalling

Once a day the app reports the Atlassian account IDs it is holding, so Atlassian can tell it which of those accounts have been closed. When one has been, the records naming that person are deleted. This runs whether or not the app is licensed, because it is a compliance obligation rather than a feature.

Uninstalling runs a handler that empties the app's storage before it goes, sweeping it repeatedly until a pass finds nothing — deleting under a cursor leaves keys behind, so one pass is not enough. Independently, Atlassian detaches the installation's data and destroys it under its own retention policy. See Where your data goes.

This only became true recently
The uninstall handler existed for months wired to a Forge event that does not exist, so it had never run once. It is a preUninstall module now, and it actually deletes.

The privacy policy is the authoritative statement on all of the above.

Troubleshooting

A scan seems stuck
Large instances genuinely take minutes. If it has actually stalled, use Start Over and re-run with a narrower scope.
Group changes were rejected
Expected. Only a site administrator can change group membership. Project roles are still applied, and the tool reports how many group changes were blocked.
A scheme will not delete
Something still references it. Re-scan: a scheme that became used between your scan and your delete is reported rather than force-deleted.
The merger CSV did not import
Use the generated config file alongside the CSV, import one batch at a time, and make sure the target field is on the relevant screens first.
User Analysis rejects a CSV
The tool names the missing columns. Re-export from admin.atlassian.com without opening the file in a spreadsheet first — that round-trip is the usual cause.
A button is greyed out and I do not know why
If there is a warning at the top of the page saying the app has no active licence, that is the reason — the actions that start work are gated, and there is a line under each disabled button saying so. Reads, exports and Cancel and start over are not gated.
Offboarding did not move everything
Categories marked info only cannot be transferred automatically. They are listed so you can handle them by hand.

Missing a tool? The Suggest a tool button on the tool list and the support portal go to the same queue.

Something missing or wrong on this page? Tell us in the support portal or email contact@synapseoasis.com.