---
updatedAt: 2026-03-08T11:19:07.000Z
---
Fetch the complete documentation index at: https://apidocs.hibob.com/llms.txt. Use this file to discover all available pages before exploring further.
# Explore Tasks API
Understand the basic concepts of Tasks and how you can access them via the Public API
# Overview
Tasks in Bob help teams stay organized and ensure company-wide responsibilities are efficiently tracked and managed. The Tasks feature allows you to monitor progress, reassign ownership, and mark tasks as completed. Tasks can be assigned for various purposes, such as onboarding new hires, completing performance reviews, or meeting compliance requirements.
The Tasks API provides programmatic access to Bob's task management system, allowing you to:
* Retrieve all open tasks or filter tasks by employee or status.
* Mark tasks as complete.
* Subscribe to task-related webhook events including task status change and task list assignment.
Common use cases for the Tasks API include integrating with project management tools, monitoring task progress, or triggering reminders.
# Key Concepts
A Task in Bob represents an actionable item assigned to an employee. Tasks help track responsibilities and ensure actions are completed on time.
Tasks fall into two main types:
* **General Tasks**:
* These are manually tracked to-do items that can be assigned and marked as complete.
* Accessible and modifiable via the Public API.
* **Other Tasks**:
* Tasks tied to automated processes or integrated modules in Bob, such as eSignatures, emails, calendar events, or surveys.
* Managed within Bob and not accessible via the Public API
Tasks can be either Open or Closed. The Public API allows filtering based on these statuses, enabling better visibility into task progress. To learn more about Tasks in Bob, see Manage tasks.
The Bob Task Lists enable assigning tasks to specific employees or groups of employees at specific times. Each task list can be set with the option to schedule according to a particular anchor event, such as a start date, work anniversary, or a particular time off policy. The scheduling can also be applied to particular people based on set conditions.
Once the scheduled time arrives, the task list is assigned to the relevant employees. The Public API allows access to task lists for General tasks, including task descriptions, due dates, and other details
# Tasks endpoints
The Tasks API provides functionality to retrieve and update tasks based on specific requirements:
| Use Case | Public API Endpoint | Description |
| :-------------------------- | :------------------------------------------------------------------------------------------- | :------------------------------------------------------------------ |
| Get all open tasks | [Read all open tasks. ](https://apidocs.hibob.com/reference/get_tasks) | Retrieve a list of all open general tasks in the organization |
| Get employee-specific tasks | [Read tasks of a specific employee](https://apidocs.hibob.com/reference/get_tasks-people-id) | Fetch general tasks assigned to a specific employee using their ID. |
| Mark a task as complete | [Mark a task as complete](https://apidocs.hibob.com/reference/post_tasks-taskid-complete) | Update the general task's status to "Closed" |
To learn more, see [Tasks endpoints](https://apidocs.hibob.com/reference/tasks).
# Webhook events
Bob supports webhook task events, allowing your system to respond to task-related events in real-time.
Use the following events to receive notifications about triggered task lists and tasks status updates. Then, use the API endpoints to retrieve the task list or change the status.
| Event | Type | Description |
| :------------------ | :----------------- | :------------------------------------------------------------------------------------------ |
| Task List Triggered | todo.assign | The payload includes all the general tasks that were triggered upon a task list assignment. |
| Task Status Changed | todo.changedStatus | The payload includes the details of the general task and the new status (Open/Closed) |
To learn more, see [Task events](https://apidocs.hibob.com/reference/tasks-webhooks).
# Common use-cases
Use the Tasks API to track onboarding tasks for new employees:
1. Retrieve all tasks for a specific employee using `GET /tasks/people/\{id}`.
2. Display these tasks in a custom employee dashboard.
3. Automatically mark tasks as complete with `POST /tasks/{taskId}/complete` when prerequisites are met.
Integrate tasks to remind managers to congratulate people on their birthdays:
1. Use `GET /tasks/people/{id}` to pull employee-specific tasks.
2. Send reminders to managers for tasks such as setting up a team time to celebrate.
Automate task tracking for compliance-related activities:
1. Assign tasks to employees to submit certifications for industry compliance.
2. Use GET /tasks to monitor pending tasks organization-wide.
3. Mark tasks as completed after submission using `POST /tasks/{taskId}/complete`.
# Related resources
* [Mastering tasks lists](https://help.hibob.com/hc/en-us/articles/14767470443665-Mastering-task-lists#h_01H9DD18BKMAMJWC7E1HF3WA0P)
* [Getting started with Bob API](https://apidocs.hibob.com/reference/getting-started-with-bob-api)
* [Set up general tasks](https://help.hibob.com/hc/en-us/articles/5549332229393-Set-up-a-general-task)
* [Getting Started with Bob Webhooks](https://apidocs.hibob.com/reference/getting-started-webhooks)
* [Employee Task Events](https://apidocs.hibob.com/reference/employee-task-events)
* [Rate limiting](https://apidocs.hibob.com/docs/rate-limit)