FlowmageDocs

List jobs

BetaReads dataVersion 2

Lists Teamtailor jobs, published or internal, with their departments.

Settings

SettingWhat it is
ConnectionRequiredThe Teamtailor connection the step signs in with.
StatusTeamtailor answers only published jobs unless you say otherwise here.
Feed"public" or "internal"
Department idPicked from the list Teamtailor offers.
Division idtext
Role idtext
Location idstext
Region idstext
Tagstext
Remote"" or "none" or "temporary" or "hybrid" or "fully"
Template nameFinds the jobs made from one template.
Created fromtext
Created up totext
Changed fromtext
Changed up totext
Also fetchRelated records to fetch with each job, comma separated.
Sort byTeamtailor's own order is -pinned,date. A minus in front turns the order around.
Jobs per call1 to 30 — Teamtailor's own maximum is 30.
Fetch every pageFollows Teamtailor's own next-page link, and refuses past 5,000 jobs rather than answering a short list.
CursorPaste a previous run's Next cursor to read the page after it.
Technical details
KeyValue
connectiontexta connection id from `requires.connections` (provider `teamtailor`)
status"published" or "unlisted" or "archived" or "draft" or "scheduled" or "all", by default "published"
feed"public" or "internal", by default "public"
departmenttexta value from the vendor's own list
divisiontext
roletext
locationstext
regionstext
tagstext
remoteStatus"" or "none" or "temporary" or "hybrid" or "fully"
templateNametext
createdFromtext
createdTotext
updatedFromtext
updatedTotext
includetext, by default "department,locations"
sorttext
pageSizenumber, by default 30
returnAlltrue/false, by default false
cursortext

Output

FieldType
itemsJobsarray
itemCountJobs in this answernumber
recordCountJobs matching the filter (all pages)number
hasMoreMore jobs are waiting behind this pageboolean
nextUrlTeamtailor's own next-page addressstring
rawThe untouched JSON:API answerobject
nextCursorCursor for the next pagestring
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>",
    "createdFrom": "",
    "createdTo": "",
    "cursor": "",
    "department": "",
    "division": "",
    "feed": "public",
    "include": "department,locations",
    "locations": "",
    "pageSize": 30,
    "regions": "",
    "remoteStatus": "",
    "returnAll": false,
    "role": "",
    "sort": "",
    "status": "published",
    "tags": "",
    "templateName": "",
    "updatedFrom": "",
    "updatedTo": ""
  },
  "label": "List jobs",
  "type": "teamtailor.listJobs",
  "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 Teamtailor connection the step signs in with.
StatusTeamtailor answers only published jobs unless you say otherwise here.
Feed"public" or "internal"
Department idPicked from the list Teamtailor offers.
Division idtext
Role idtext
Location idstext
Region idstext
Tagstext
Remote"" or "none" or "temporary" or "hybrid" or "fully"
Template nameFinds the jobs made from one template.
Created fromtext
Created up totext
Changed fromtext
Changed up totext
Also fetchRelated records to fetch with each job, comma separated.
Sort byTeamtailor's own order is -pinned,date. A minus in front turns the order around.
Jobs per call1 to 30 — Teamtailor's own maximum is 30.
Fetch every pageFollows Teamtailor's own next-page link, and refuses past 5,000 jobs rather than answering a short list.
Technical details
KeyValue
connectiontexta connection id from `requires.connections` (provider `teamtailor`)
status"published" or "unlisted" or "archived" or "draft" or "scheduled" or "all", by default "published"
feed"public" or "internal", by default "public"
departmenttexta value from the vendor's own list
divisiontext
roletext
locationstext
regionstext
tagstext
remoteStatus"" or "none" or "temporary" or "hybrid" or "fully"
templateNametext
createdFromtext
createdTotext
updatedFromtext
updatedTotext
includetext, by default "department,locations"
sorttext
pageSizenumber, by default 30
returnAlltrue/false, by default false