FlowmageDocs

List projects

BetaReads data

Lists the Personio projects that hours can be booked against.

Settings

SettingWhat it is
ConnectionRequiredThe Personio connection the step signs in with.
Project idstext
NamesExact names, comma-separated.
Project codestext
Parent project idsAnswers the subprojects of these projects.
Status"" or "ACTIVE" or "ARCHIVED"
Top-level projects onlytrue/false
Extra fieldsComma-separated. Personio leaves these out unless you ask for them.
CursorPaste a previous run's Next cursor to read the page after it.
Projects per call1 to 200.
Fetch every pageFollows Personio's next-page cursor, and refuses past 5,000 projects rather than answering a short list.
Technical details
KeyValue
connectiontexta connection id from `requires.connections` (provider `personio`)
idstext
namestext
projectCodestext
parentProjectIdstext
status"" or "ACTIVE" or "ARCHIVED"
topLevelOnlytrue/false, by default false
includetext
cursortext
limitnumber, by default 200
returnAlltrue/false, by default false

Output

FieldType
projectsarray
projectCountProjects in this answernumber
hasMoreMore projects are waiting behind this pageboolean
nextCursorCursor for the next pagestring
Sample output, and the expression for each field
  • hasMorefalse
  • nextCursor""
  • projectCount0
  • 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": "",
    "ids": "",
    "include": "",
    "limit": 200,
    "names": "",
    "parentProjectIds": "",
    "projectCodes": "",
    "returnAll": false,
    "status": "",
    "topLevelOnly": false
  },
  "label": "List projects",
  "type": "personio.listProjects",
  "version": 1
}