FlowmageDocs

List projects

BetaReads dataVersion 2

Lists Jira projects and their keys.

Settings

SettingWhat it is
ConnectionRequiredThe Jira connection the step signs in with.
Name or key containsMatches a project's name or its key.
Only these keysComma-separated project keys.
Kind"" or "software" or "service_desk" or "business"
Order by"key" or "name" or "-name" or "lastIssueUpdatedTime"
Projects per call1 to 100 — Jira's own maximum on this endpoint.
Fetch every pageWalks Jira's offset pages, and refuses past 5,000 projects.
CursorPaste a previous run's Next cursor to read the page after it.
Technical details
KeyValue
connectiontexta connection id from `requires.connections` (provider `jira`)
querytext
keystext
projectType"" or "software" or "service_desk" or "business"
orderBy"key" or "name" or "-name" or "lastIssueUpdatedTime", by default "key"
limitnumber, by default 100
returnAlltrue/false, by default true
cursortext

Output

FieldType
projectsarray
projectCountProjects in this answernumber
projectKeysProject name → its keyobject
hasMoreMore projects are waiting behind this pageboolean
nextCursorCursor for the next pagestring
Sample output, and the expression for each field
  • hasMorefalse
  • projectCount0
  • projectKeys{}
  • projects[]

Errors

When a step of this node stops a run, the run page shows a code. Look it up:

Example step

The step as a flow file holds it. Replace each value in <…>.

{
  "config": {
    "connection": "<connection id>",
    "cursor": "",
    "keys": "",
    "limit": 100,
    "orderBy": "key",
    "projectType": "",
    "query": "",
    "returnAll": true
  },
  "label": "List projects",
  "type": "jira.listProjects",
  "version": 2
}

Older versions

A flow that already has this version keeps running it. A new step always gets the newest.

Version 1
SettingWhat it is
ConnectionRequiredThe Jira connection the step signs in with.
Name or key containsMatches a project's name or its key.
Only these keysComma-separated project keys.
Kind"" or "software" or "service_desk" or "business"
Order by"key" or "name" or "-name" or "lastIssueUpdatedTime"
Projects per call1 to 100 — Jira's own maximum on this endpoint.
Fetch every pageWalks Jira's offset pages, and refuses past 5,000 projects.
Technical details
KeyValue
connectiontexta connection id from `requires.connections` (provider `jira`)
querytext
keystext
projectType"" or "software" or "service_desk" or "business"
orderBy"key" or "name" or "-name" or "lastIssueUpdatedTime", by default "key"
limitnumber, by default 100
returnAlltrue/false, by default true