Tasks

List task boards

get/v1/public/task-boards

Returns all task boards in the organization with their columns, members, and task count.

curl -X GET "https://api.cognizy.ai/api/v1/public/task-boards" \
  -H "Authorization: Bearer $COGNIZY_API_KEY"

Get a task board

get/v1/public/task-boards/{id}

Returns a single board with columns, tasks nested per column, labels, and members. Use list_tasks below to query tasks with filters and pagination instead of pulling the full board.

curl -X GET "https://api.cognizy.ai/api/v1/public/task-boards/<id>" \
  -H "Authorization: Bearer $COGNIZY_API_KEY"

List tasks in a board

get/v1/public/task-boards/{id}/tasks

Paginated tasks within a board, with composable filters: column, assignee, label, overdue, completed.

curl -X GET "https://api.cognizy.ai/api/v1/public/task-boards/<id>/tasks" \
  -H "Authorization: Bearer $COGNIZY_API_KEY"

Create a task in a board

post/v1/public/task-boards/{id}/tasks

Accepts Idempotency-Key

Creates a new task in a specific column of a board. Most fields are optional; only title and columnId are required. Defaults to aiGenerated: true when called via the public API (overrideable in body) so the dashboard surfaces tasks that came from MCP/integrations distinctly from human-created ones. Returns the full task row with assignees, labels, counts.

curl -X POST "https://api.cognizy.ai/api/v1/public/task-boards/<id>/tasks" \
  -H "Authorization: Bearer $COGNIZY_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
  "title": "texto",
  "columnId": "column_123",
  "description": "texto",
  "priority": "LOW",
  "dueDate": "2026-11-12T14:00:00.000Z",
  "estimatedMinutes": 0,
  "assigneeIds": [
    "assignee_123"
  ],
  "labelIds": [
    "label_123"
  ],
  "conversationId": "conversation_123",
  "contactId": "contact_123",
  "aiGenerated": true,
  "aiReason": "texto",
  "parentId": "parent_123"
}'

Get a task by id

get/v1/public/tasks/{id}

Returns the full task: description, checklist, subtasks, recent activities (50), assignees, labels, linked conversation/contact.

curl -X GET "https://api.cognizy.ai/api/v1/public/tasks/<id>" \
  -H "Authorization: Bearer $COGNIZY_API_KEY"

Update task fields

patch/v1/public/tasks/{id}

Accepts Idempotency-Key

Partial update of task fields (title, description, priority, dueDate, estimatedMinutes). Pass dueDate: null to clear it. Other omitted fields are left untouched. Triggers PRIORITY_CHANGED / DUE_DATE_CHANGED / UPDATED activity entries as applicable.

curl -X PATCH "https://api.cognizy.ai/api/v1/public/tasks/<id>" \
  -H "Authorization: Bearer $COGNIZY_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
  "title": "texto",
  "description": "texto",
  "priority": "LOW",
  "dueDate": "2026-11-12T14:00:00.000Z",
  "estimatedMinutes": 0
}'

Delete a task

delete/v1/public/tasks/{id}

Removes a task entirely. Cascades to comments, checklist items, attachments, and subtasks. Idempotent — succeeds with 204 even if the task was already gone or never belonged to your org (cross-tenant ids are not revealed).

curl -X DELETE "https://api.cognizy.ai/api/v1/public/tasks/<id>" \
  -H "Authorization: Bearer $COGNIZY_API_KEY"

Add a comment to a task

post/v1/public/tasks/{id}/comments

Accepts Idempotency-Key

Posts a comment authored by the user who created the API key (or the org owner as fallback). Triggers the same notifications and activity log entry as an in-app comment. Use this from MCP/external agents to surface findings on tasks ("AI detected this ticket is at-risk", "Suggested fix: X").

curl -X POST "https://api.cognizy.ai/api/v1/public/tasks/<id>/comments" \
  -H "Authorization: Bearer $COGNIZY_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
  "content": "texto",
  "parentId": "parent_123"
}'

Add a checklist item to a task

post/v1/public/tasks/{id}/checklist

Accepts Idempotency-Key

Appends a new checklist item at the end of the task's checklist. Triggers a CHECKLIST_ITEM_ADDED activity entry.

curl -X POST "https://api.cognizy.ai/api/v1/public/tasks/<id>/checklist" \
  -H "Authorization: Bearer $COGNIZY_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
  "title": "texto"
}'

Toggle a checklist item completion

post/v1/public/tasks/{id}/checklist/{itemId}/toggle

Accepts Idempotency-Key

Flips completed on/off. Adding done: true would let the caller force-set instead of toggle, but toggle is simpler and mirrors the in-app UI button. Triggers CHECKLIST_ITEM_COMPLETED activity when completing.

curl -X POST "https://api.cognizy.ai/api/v1/public/tasks/<id>/checklist/<itemId>/toggle" \
  -H "Authorization: Bearer $COGNIZY_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)"

Delete a checklist item

delete/v1/public/tasks/{id}/checklist/{itemId}

curl -X DELETE "https://api.cognizy.ai/api/v1/public/tasks/<id>/checklist/<itemId>" \
  -H "Authorization: Bearer $COGNIZY_API_KEY"

Attach a label to a task

post/v1/public/tasks/{id}/labels/{labelId}

Accepts Idempotency-Key

Verifies the label belongs to the caller's org before attaching. Idempotent at the data layer via PK constraint — re-attach raises Prisma P2002 which we swallow.

curl -X POST "https://api.cognizy.ai/api/v1/public/tasks/<id>/labels/<labelId>" \
  -H "Authorization: Bearer $COGNIZY_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)"

Detach a label from a task

delete/v1/public/tasks/{id}/labels/{labelId}

curl -X DELETE "https://api.cognizy.ai/api/v1/public/tasks/<id>/labels/<labelId>" \
  -H "Authorization: Bearer $COGNIZY_API_KEY"

Move a task to a different column / position

post/v1/public/tasks/{id}/move

Accepts Idempotency-Key

Move within the same board. The target column must belong to the task's current board (TaskService enforces this). Pass position as a 0-based index in the destination column. Triggers MOVED activity entry; auto-sets completedAt / archivedAt when the target column has those flags.

curl -X POST "https://api.cognizy.ai/api/v1/public/tasks/<id>/move" \
  -H "Authorization: Bearer $COGNIZY_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
  "columnId": "column_123",
  "position": 0
}'

Assign a user to a task

post/v1/public/tasks/{id}/assignees/{userId}

Accepts Idempotency-Key

Idempotent — re-assigning the same user is treated as success (TaskService raises BadRequestException for duplicates; we map that to 204). The user must be a member of the same org. Sends an in-app notification to the new assignee.

curl -X POST "https://api.cognizy.ai/api/v1/public/tasks/<id>/assignees/<userId>" \
  -H "Authorization: Bearer $COGNIZY_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)"

Unassign a user from a task

delete/v1/public/tasks/{id}/assignees/{userId}

Idempotent — succeeds even if the user wasn't assigned.

curl -X DELETE "https://api.cognizy.ai/api/v1/public/tasks/<id>/assignees/<userId>" \
  -H "Authorization: Bearer $COGNIZY_API_KEY"