Comments, reactions, checklists, and activity API
Build task discussions, attach evidence, manage checklist steps, and retrieve task or board activity logs through REST endpoints.
Before you begin
Use https://tasker.fit/api as the REST base URL. Create an active integration token in Profile → API Tokens, and send Authorization: Bearer <your-api-token>. Replace all example IDs with values returned for your account.
Planning your workflow
Comments use the comment field for their text. They are scoped to a task and can include uploaded attachment_ids. Editing a comment identifies comment_id in the query and sends changed content in JSON. Reactions are a special case: both adding and removing a reaction use a JSON body containing the task scope, comment_id, and reaction value, even for DELETE.
A task contains named checklists and checklist items. Create a checklist first, then retain its numeric checklist_id when adding items. Item completion uses is_selected, not is_ready. Task and board activity endpoints are read-only histories of supported changes; they are not generic data-export or audit-download endpoints.
Example
Build task discussions, attach evidence, manage checklist steps, and retrieve task or board activity logs through REST endpoints.
Step-by-step tutorials / 1
Integration workflow
Read a task and create a checklist with a title appropriate to the work.
Create checklist items, retain their IDs, and PATCH is_selected when each step is verified.
Post a progress comment and inspect the returned comment ID before reacting or editing. Read activity to confirm recorded changes.
What to expect: Read the returned data object and keep the resource identifiers for subsequent requests. Check the HTTP status before treating a write operation as successful.
Endpoints and request examples
Replace example identifiers, tokens, and dates with your own values. Each example shows fields for a specific operation, rather than a complete response schema.
| Method | Path | Operation |
|---|---|---|
| GET | /task/comments/ | List task comments |
| POST | /task/comments/ | Create a comment |
| PATCH | /task/comments/ | Edit a comment |
| DELETE | /task/comments/ | Delete a comment |
| POST | /task/comments/reactions/ | Add a reaction |
| DELETE | /task/comments/reactions/ | Remove your reaction |
| POST | /task/checklist/ | Create a checklist |
| PATCH | /task/checklist/ | Rename a checklist |
| DELETE | /task/checklist/ | Delete a checklist |
| POST | /task/checklist/item/ | Add a checklist item |
| PATCH | /task/checklist/item/ | Complete a checklist item |
| DELETE | /task/checklist/item/ | Delete a checklist item |
| GET | /task/activity/ | Read task activity |
| GET | /board/activity/ | Read board activity |
/api/task/comments/List task comments
Authentication and permission for this operation are required.
URL query parameters (example)
{
"company_id": "demo",
"board_id": "RELEASE",
"task_id": "<task-id>"
}Additional fields: page, limit, q
cURL example
curl --request GET 'https://tasker.fit/api/task/comments/?company_id=demo&board_id=RELEASE&task_id=%3Ctask-id%3E' \
--header 'Authorization: Bearer <your-api-token>'/api/task/comments/Create a comment
Authentication and permission for this operation are required.
JSON request body (example)
{
"company_id": "demo",
"board_id": "RELEASE",
"task_id": "<task-id>",
"comment": "Checkout verification is ready for review."
}Additional fields: attachment_ids
cURL example
curl --request POST 'https://tasker.fit/api/task/comments/' \
--header 'Authorization: Bearer <your-api-token>' \
--header 'Content-Type: application/json' \
--data '{
"company_id": "demo",
"board_id": "RELEASE",
"task_id": "<task-id>",
"comment": "Checkout verification is ready for review."
}'/api/task/comments/Edit a comment
Authentication and permission for this operation are required.
URL query parameters (example)
{
"company_id": "demo",
"board_id": "RELEASE",
"task_id": "<task-id>",
"comment_id": 4
}JSON request body (example)
{
"comment": "Verification complete."
}Additional fields: attachment_ids
cURL example
curl --request PATCH 'https://tasker.fit/api/task/comments/?company_id=demo&board_id=RELEASE&task_id=%3Ctask-id%3E&comment_id=4' \
--header 'Authorization: Bearer <your-api-token>' \
--header 'Content-Type: application/json' \
--data '{
"comment": "Verification complete."
}'/api/task/comments/Delete a comment
Authentication and permission for this operation are required.
URL query parameters (example)
{
"company_id": "demo",
"board_id": "RELEASE",
"task_id": "<task-id>",
"comment_id": 4
}cURL example
curl --request DELETE 'https://tasker.fit/api/task/comments/?company_id=demo&board_id=RELEASE&task_id=%3Ctask-id%3E&comment_id=4' \
--header 'Authorization: Bearer <your-api-token>'/api/task/comments/reactions/Add a reaction
Authentication and permission for this operation are required.
JSON request body (example)
{
"company_id": "demo",
"board_id": "RELEASE",
"task_id": "<task-id>",
"comment_id": 4,
"reaction": "👍"
}cURL example
curl --request POST 'https://tasker.fit/api/task/comments/reactions/' \
--header 'Authorization: Bearer <your-api-token>' \
--header 'Content-Type: application/json' \
--data '{
"company_id": "demo",
"board_id": "RELEASE",
"task_id": "<task-id>",
"comment_id": 4,
"reaction": "👍"
}'/api/task/comments/reactions/Remove your reaction
Authentication and permission for this operation are required.
JSON request body (example)
{
"company_id": "demo",
"board_id": "RELEASE",
"task_id": "<task-id>",
"comment_id": 4,
"reaction": "👍"
}cURL example
curl --request DELETE 'https://tasker.fit/api/task/comments/reactions/' \
--header 'Authorization: Bearer <your-api-token>' \
--header 'Content-Type: application/json' \
--data '{
"company_id": "demo",
"board_id": "RELEASE",
"task_id": "<task-id>",
"comment_id": 4,
"reaction": "👍"
}'/api/task/checklist/Create a checklist
Authentication and permission for this operation are required.
JSON request body (example)
{
"company_id": "demo",
"board_id": "RELEASE",
"task_id": "<task-id>",
"title": "Release checks"
}Additional fields: position, items
cURL example
curl --request POST 'https://tasker.fit/api/task/checklist/' \
--header 'Authorization: Bearer <your-api-token>' \
--header 'Content-Type: application/json' \
--data '{
"company_id": "demo",
"board_id": "RELEASE",
"task_id": "<task-id>",
"title": "Release checks"
}'/api/task/checklist/Rename a checklist
Authentication and permission for this operation are required.
URL query parameters (example)
{
"company_id": "demo",
"board_id": "RELEASE",
"task_id": "<task-id>",
"checklist_id": 5
}JSON request body (example)
{
"title": "Payment checks"
}Additional fields: position
cURL example
curl --request PATCH 'https://tasker.fit/api/task/checklist/?company_id=demo&board_id=RELEASE&task_id=%3Ctask-id%3E&checklist_id=5' \
--header 'Authorization: Bearer <your-api-token>' \
--header 'Content-Type: application/json' \
--data '{
"title": "Payment checks"
}'/api/task/checklist/Delete a checklist
Authentication and permission for this operation are required.
URL query parameters (example)
{
"company_id": "demo",
"board_id": "RELEASE",
"task_id": "<task-id>",
"checklist_id": 5
}cURL example
curl --request DELETE 'https://tasker.fit/api/task/checklist/?company_id=demo&board_id=RELEASE&task_id=%3Ctask-id%3E&checklist_id=5' \
--header 'Authorization: Bearer <your-api-token>'/api/task/checklist/item/Add a checklist item
Authentication and permission for this operation are required.
JSON request body (example)
{
"company_id": "demo",
"board_id": "RELEASE",
"task_id": "<task-id>",
"checklist_id": 5,
"title": "Verify the confirmation",
"is_selected": false
}Additional fields: position
cURL example
curl --request POST 'https://tasker.fit/api/task/checklist/item/' \
--header 'Authorization: Bearer <your-api-token>' \
--header 'Content-Type: application/json' \
--data '{
"company_id": "demo",
"board_id": "RELEASE",
"task_id": "<task-id>",
"checklist_id": 5,
"title": "Verify the confirmation",
"is_selected": false
}'/api/task/checklist/item/Complete a checklist item
Authentication and permission for this operation are required.
URL query parameters (example)
{
"company_id": "demo",
"board_id": "RELEASE",
"task_id": "<task-id>",
"item_id": 6
}JSON request body (example)
{
"is_selected": true
}Additional fields: title, position
cURL example
curl --request PATCH 'https://tasker.fit/api/task/checklist/item/?company_id=demo&board_id=RELEASE&task_id=%3Ctask-id%3E&item_id=6' \
--header 'Authorization: Bearer <your-api-token>' \
--header 'Content-Type: application/json' \
--data '{
"is_selected": true
}'/api/task/checklist/item/Delete a checklist item
Authentication and permission for this operation are required.
URL query parameters (example)
{
"company_id": "demo",
"board_id": "RELEASE",
"task_id": "<task-id>",
"item_id": 6
}cURL example
curl --request DELETE 'https://tasker.fit/api/task/checklist/item/?company_id=demo&board_id=RELEASE&task_id=%3Ctask-id%3E&item_id=6' \
--header 'Authorization: Bearer <your-api-token>'/api/task/activity/Read task activity
Authentication and permission for this operation are required.
URL query parameters (example)
{
"company_id": "demo",
"board_id": "RELEASE",
"task_id": "<task-id>"
}Additional fields: actor_ids, action, page, limit, q
cURL example
curl --request GET 'https://tasker.fit/api/task/activity/?company_id=demo&board_id=RELEASE&task_id=%3Ctask-id%3E' \
--header 'Authorization: Bearer <your-api-token>'/api/board/activity/Read board activity
Authentication and permission for this operation are required.
URL query parameters (example)
{
"company_id": "demo",
"board_id": "RELEASE"
}Additional fields: actor_ids, action, page, limit, q
cURL example
curl --request GET 'https://tasker.fit/api/board/activity/?company_id=demo&board_id=RELEASE' \
--header 'Authorization: Bearer <your-api-token>'Tips & troubleshooting
- Examples show the key request fields, not every optional field or a full response schema. Query fields belong in the URL; JSON body fields belong in the request body. Keep trailing slashes on endpoint paths.
Frequently asked questions
Can these examples be used with any account?
Only resources accessible to the token's account can be read or changed. Use returned company, board, task, and numeric resource IDs; the examples' demo values are placeholders.
What should an integration do when a request fails?
Check the HTTP status and returned error payload. Validate identifiers and required fields, then check token activity, expiry, and permissions. Do not blindly repeat a POST: a previous attempt may already have created a resource.