List Projects

jira.list_projects

ActionBusiness appsconnection required

Calls the Jira Cloud REST API with the connection's email and API token.

List the Jira projects the connection can see.

Ask about Jira All Jira nodes Provider API docs ↗

Connection

Required: Yes — the node will not save without one
Auth type: Username & password
Providers: Jira
Secret shape: {"email", "api_token"}
Config it needs: domain
Resolved by: config.connection_id, else node.connection_id

Configuration

4 fields, none required. A dotted path is a nested object and name[] an array of objects — the editor renders the same tree.

Field	Type	Required	Default	Constraints	Example
query Filter to projects whose key or name contains this text.	string	No	—	—	—
start_at Index of the first result to return, for paging through a long list.	number	No	0	≥ 0	—
max_results Maximum results to return in one call (1-100).	number	No	50	1–100	—
order_by Field to sort the page by; a '-' prefix reverses it.	string	No	key	one of "key", "-key", "name", "-name", "category", "-category", "issueCount", "-issueCount"	—

Example configuration

Every value below is the contract’s own example or default — nothing invented.

{
  "max_results": 50,
  "order_by": "key",
  "start_at": 0
}

Output

One shape.

result

Field	Type	Example
projects[].id The project's numeric id, as a string.	string	—
projects[].key The project key.	string	ENG
projects[].name The project's display name.	string	—
projects[].projectTypeKey 'software', 'service_desk' or 'business'.	string	—
count How many items this call returned.	number	—
total How many items match in total, when Jira reports one.	number	—
start_at Index of the first item in this page.	number	—
is_last True when this is the final page of results.	boolean	—

{
  "count": 0,
  "is_last": false,
  "projects": [
    {
      "id": "",
      "key": "ENG",
      "name": "",
      "projectTypeKey": ""
    }
  ],
  "start_at": 0,
  "total": 0
}

Related Jira nodes

Templates that use Jira

Solutions with Jira

See List Projects run in a workflow.

In a technical demo we add the Jira connection, drop the node on the canvas and let Workflow Health pre-flight it before the first real run.

Book a technical demo Talk to sales