How to filter out site settings linked to Team-Managed projects using Jira GET REST APIs

Question

Hi team.

I'm currently working on an automation tool that will back up and restore all the site-level settings, projects, and issues on Jira Cloud. It covers backup and restores of all site-level settings (issue types, workflows, screens, fields, etc.), boards, filters, dashboards, projects and project metadata, and issues and their metadata. We only back up Company-Managed projects, not Team-Managed projects.

However, since we do not back up Team-Managed (Next-Gen) projects, during restore we observed failures for certain items (like boards, filters, and dashboard gadgets) that were originally linked to Team-Managed projects. As far as I understand, most site-level settings in Jira Cloud (like workflows, screens, issue type schemes, etc.) are global and not linked to Team-Managed projects.

However, there are some items that are created specifically for a Team-Managed project, such as:

* Boards created under a Team-Managed project
* Filters whose JQL references a Team-Managed project key
* Dashboards, Permission schemes, and Notification schemes that have permissions referencing a Team-Managed project

Since these items appear in the standard GET REST APIs (Boards API, Filters API, etc.), they look similar to items from Company-Managed projects even though they belong to Team-Managed ones.

My questions are:

* Is there a reliable REST API way to detect if a project is Team-Managed or Company-Managed?
I see the style field ("classic" vs "next-gen") in the /rest/api/3/project/{id} response — is this the recommended method?
* Is there any official guideline or filter to determine which site-level settings belong to Team-Managed projects, so we can safely skip backing them up or restoring them?
For example: in the GET response (e.g., GET /rest/api/3/dashboard), is there any filter to show only the settings linked to Company-Managed projects?
* Are boards/filters created under Team-Managed projects (and dashboards/permission schemes/notification schemes that reference Team-Managed projects) expected to appear in the GET APIs? Or is there a way to differentiate them before attempting restore?

Any best practices or recommended approach from Atlassian for handling these scenarios would be really helpful.

Thanks in advance!

unknown · Answer

Hello @gopal guna

To me, it sounds like you've not done any preliminary research into Jira's REST API to discover the scope of what site configuration settings it can or can't manage. If so, you would have discovered just how many site level settings either cannot be managed via the REST API, or can be, but only through a very, VERY convoluted sequence. As a result, attempting to build such an 'automation' would be an incredibly complex and laborious undertaking, even for a small team of very experienced developers with domain specific skills!

You really are much, much better off just purchasing and using one of the commercial configuration manager apps from the Marketplace, such as those from Revyz or Appfire

As for an 'automation' that backs up all the site data (project, issues etc), if you search this forum on that topic you will find that on an almost monthly basis, someone claims they're going to build the same thing, then invariably asks the same "Any best practices or recommended approach for doing this would be really helpful" question.

The response is always the same... you're asking the equivalent of a "How do I build a space ship?" question. You've not realised the complexity of the problem nor the scale of effort required to solve it. You're much better off getting a commercial Jira data backup and restore app from the Marketplace.

I hope you can take all this advice in the manner it was intended.

Mykenna Cepek · Answer

For your first question, I recommend the REST API endpoint you found that differentiates "classic" (Company Managed) vs "next-gen" (Team Managed) projects spaces. I'm using that in my automation rules to differentiate the types of projects.

For your other two questions, I'll just admit to owning a t-shirt that says "Friends don't let friends use Team-Managed Project".