List task lists
Task lists and their tasks from the Onboarding or Offboarding settings.
GET https://cotlet.dev/api/v1/bamboohr/task-lists
read
Returns every list from the Onboarding or Offboarding settings with its tasks, including the Miscellaneous Tasks list BambooHR keeps for tasks without a list. Each task shows its default assignee, when the filters apply and the notification timing set for it. Use list_id in add_task_lists. Reads settings only and changes nothing.
Parameters
| Name | Type | Description |
|---|---|---|
| kind string required | string | Which checklist: 'onboarding' or 'offboarding'. |
Request
curl "https://cotlet.dev/api/v1/bamboohr/task-lists?kind=kind" \
-H "Authorization: Bearer $COTLET_API_KEY"result = client.call("bamboohr", "list_task_lists", {"kind":"kind"})const result = await cotlet.call('bamboohr', 'list_task_lists', {"kind":"kind"});cotlet call bamboohr list_task_lists --data '{"kind":"kind"}'Example response
{
"kind": "onboarding",
"lists": [
{
"list_id": "tl_it_setup",
"name": "IT setup",
"tasks": [
{
"task": "Order laptop",
"assignee": "Priya Shah",
"notify": "on due date"
},
{
"task": "Create accounts",
"assignee": "Priya Shah",
"notify": "a day before due date"
}
]
},
{
"list_id": "tl_manager",
"name": "Manager tasks",
"tasks": [
{
"task": "Schedule first-week 1:1",
"assignee": "Hiring manager",
"notify": "15 minutes after assigned"
}
]
},
{
"list_id": "tl_misc",
"name": "Miscellaneous Tasks",
"tasks": []
}
]
}