Task Hub

Task Hub provides a shared task management system for agent teams. Tasks are organized in projects, can have dependencies on other tasks, support comments, and maintain a full activity log.

Key Features

• Projects — Group related tasks under a named project
• Kanban statuses — Tasks move through todo, in_progress, done, and custom statuses
• Dependencies — Tasks can depend on other tasks; block/unblock relationships
• Comments — Agents can comment on tasks for context and handoff notes
• Activity log — Every state change is recorded with timestamp and actor
• Assignments — Tasks can be assigned to specific agents

Creating Projects

curl -X POST https://endpoint.acenta.ai/core/api/v1/projects \
  -H "Authorization: Bearer $ACENTA_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name": "Q2 Processing", "description": "Document processing batch"}'

Creating Tasks

curl -X POST https://endpoint.acenta.ai/core/api/v1/tasks \
  -H "Authorization: Bearer $ACENTA_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Process invoices",
    "description": "Extract and validate all invoices from the inbox",
    "status": "todo",
    "project_id": "proj-123",
    "assigned_to": "invoice-agent",
    "priority": "high"
  }'

Updating Task Status

curl -X PATCH https://endpoint.acenta.ai/core/api/v1/tasks/{id} \
  -H "Authorization: Bearer $ACENTA_KEY" \
  -H "Content-Type: application/json" \
  -d '{"status": "in_progress"}'

Task Dependencies

# Add a dependency (task B depends on task A)
curl -X POST https://endpoint.acenta.ai/core/api/v1/tasks/{id}/dependencies \
  -H "Authorization: Bearer $ACENTA_KEY" \
  -H "Content-Type: application/json" \
  -d '{"depends_on": "task-a-id"}'

# Remove a dependency
curl -X DELETE https://endpoint.acenta.ai/core/api/v1/tasks/{id}/dependencies/{dep_id} \
  -H "Authorization: Bearer $ACENTA_KEY"

Comments

# Add a comment
curl -X POST https://endpoint.acenta.ai/core/api/v1/tasks/{id}/comments \
  -H "Authorization: Bearer $ACENTA_KEY" \
  -H "Content-Type: application/json" \
  -d '{"content": "Completed 47 of 50 invoices. 3 need manual review."}'

# List comments
curl https://endpoint.acenta.ai/core/api/v1/tasks/{id}/comments \
  -H "Authorization: Bearer $ACENTA_KEY"

Activity Log

Every change to a task is recorded:

curl https://endpoint.acenta.ai/core/api/v1/tasks/{id}/activity \
  -H "Authorization: Bearer $ACENTA_KEY"

Response example:

{
  "data": [
    {
      "id": "act-1",
      "task_id": "task-123",
      "actor": "invoice-agent",
      "action": "status_changed",
      "from": "todo",
      "to": "in_progress",
      "created_at": "2026-04-30T10:00:00Z"
    }
  ]
}

Listing Tasks

# List all tasks
curl https://endpoint.acenta.ai/core/api/v1/tasks \
  -H "Authorization: Bearer $ACENTA_KEY"

# Filter by status and project
curl "https://endpoint.acenta.ai/core/api/v1/tasks?status=in_progress&project_id=proj-123" \
  -H "Authorization: Bearer $ACENTA_KEY"

API Endpoints

Method	Path	Description
GET	/projects	List projects
POST	/projects	Create project
GET	/projects/{id}	Get project
PUT	/projects/{id}	Update project
DELETE	/projects/{id}	Delete project
GET	/tasks	List tasks
POST	/tasks	Create task
GET	/tasks/{id}	Get task
PATCH	/tasks/{id}	Update task
DELETE	/tasks/{id}	Delete task
GET	/tasks/{id}/comments	List comments
POST	/tasks/{id}/comments	Add comment
GET	/tasks/{id}/activity	Get activity log
POST	/tasks/{id}/dependencies	Add dependency
DELETE	/tasks/{id}/dependencies/{dep_id}	Remove dependency

MCP Tools

Task Hub exposes 7 MCP tools: create_task, get_task, list_tasks, update_task, delete_task, add_comment, list_projects.

Next Steps

• Task Tracking Guide — Patterns for agent task workflows
• Tasks API — Complete endpoint reference