TeamtailorList stages
Lists the stages of a Teamtailor job's pipeline, in order.
Settings
| Setting | What it is |
|---|---|
| ConnectionRequired | The Teamtailor connection the step signs in with. |
| Job id | Fill this in: Teamtailor only sorts stages by their board order when the list is narrowed to one job. |
| Stage type | "" or "Inbox" or "In process" or "Hired" |
| Also fetch | text |
| Sort by | row-order is the board's own order, and only sorts right inside one job. |
| Stages per call | 1 to 30 — Teamtailor's own maximum is 30. |
| Fetch every page | Follows Teamtailor's own next-page link, and refuses past 5,000 stages rather than answering a short list. |
| Cursor | Paste a previous run's Next cursor to read the page after it. |
Technical details
| Key | Value |
|---|---|
connection | texta connection id from `requires.connections` (provider `teamtailor`) |
jobId | text |
stageType | "" or "Inbox" or "In process" or "Hired" |
include | text |
sort | text, by default "row-order" |
pageSize | number, by default 30 |
returnAll | true/false, by default true |
cursor | text |
Output
| Field | Type |
|---|---|
itemsStages | array |
itemCountStages in this answer | number |
recordCountStages matching the filter (all pages) | number |
hasMoreMore stages are waiting behind this page | boolean |
nextUrlTeamtailor's own next-page address | string |
rawThe untouched JSON:API answer | object |
nextCursorCursor for the next page | string |
Sample output, and the expression for each field
- hasMorefalse
- itemCount0
- items[]
- nextUrl""
- raw
- data[]
- included[]
- linksnull
- metanull
- recordCount0
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": "",
"include": "",
"jobId": "",
"pageSize": 30,
"returnAll": true,
"sort": "row-order",
"stageType": ""
},
"label": "List stages",
"type": "teamtailor.listStages",
"version": 2
}Older versions
A flow that already has this version keeps running it. A new step always gets the newest.
Version 1
| Setting | What it is |
|---|---|
| ConnectionRequired | The Teamtailor connection the step signs in with. |
| Job id | Fill this in: Teamtailor only sorts stages by their board order when the list is narrowed to one job. |
| Stage type | "" or "Inbox" or "In process" or "Hired" |
| Also fetch | text |
| Sort by | row-order is the board's own order, and only sorts right inside one job. |
| Stages per call | 1 to 30 — Teamtailor's own maximum is 30. |
| Fetch every page | Follows Teamtailor's own next-page link, and refuses past 5,000 stages rather than answering a short list. |
Technical details
| Key | Value |
|---|---|
connection | texta connection id from `requires.connections` (provider `teamtailor`) |
jobId | text |
stageType | "" or "Inbox" or "In process" or "Hired" |
include | text |
sort | text, by default "row-order" |
pageSize | number, by default 30 |
returnAll | true/false, by default true |