Jira Data Center icon

Jira Data Center

Interact with Jira Data Center API

Actions16

Project → Get All

AI-generated

Overview

This node integrates with the Jira Data Center API to manage Jira projects and related entities. Specifically, for the Project resource with the Get All operation, it retrieves a list of all projects available in the Jira instance. This is useful for scenarios where you want to fetch project metadata for reporting, automation workflows, or to dynamically populate options in other parts of your workflow.

For example, you might use this node to:

  • Retrieve all projects to display them in a dashboard.
  • Automate project audits by fetching project details regularly.
  • Use the list of projects as input for creating issues or assigning tasks in other nodes.

Properties

Name Meaning
Authentication Method of authentication to Jira Data Center API. Options: "Personal Access Token", "Basic Auth"
Return All Whether to return all projects or limit the number of results returned (true/false).
Limit Maximum number of projects to return if "Return All" is false. Range: 1 to 500.

Output

The output is a JSON array where each element represents a Jira project object as returned by the Jira Data Center API endpoint /rest/api/2/project. Each project object typically includes fields such as project key, name, id, and other metadata describing the project.

Example structure of one project item (simplified):

{
  "id": "10000",
  "key": "PROJ",
  "name": "Project Name",
  "projectTypeKey": "software",
  "lead": {
    "displayName": "Project Lead"
  }
}

No binary data is output by this operation.

Dependencies

  • Requires access to a Jira Data Center instance.
  • Requires credentials for Jira Data Center API authentication, either via a personal access token or basic authentication.
  • The node expects the Jira server URL to be configured in the credentials.
  • No additional external dependencies beyond the Jira API.

Troubleshooting

  • Authentication errors: Ensure that the provided API token or basic auth credentials are valid and have sufficient permissions to read projects.
  • API request failures: Network issues or incorrect Jira server URL configuration can cause failures. Verify connectivity and credential settings.
  • Limit and pagination: If not returning all projects, ensure the limit is within allowed bounds (1-500). If many projects exist, consider enabling "Return All" to fetch everything.
  • Unsupported operations: Using an operation other than "Get All" or "Get" on the Project resource will throw an error.

Common error message example:

Jira Data Center API request failed: <error message>

Resolution: Check credentials, Jira server URL, and network connectivity.

Links and References

Discussion