Task Tracking

This guide covers patterns for using Task Hub to coordinate work across an agent team.

Setting Up a Project

Create a project to group related tasks:

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

Task Lifecycle

A typical task moves through these statuses: todo → in_progress → done.

# Create
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", "status": "todo", "project_id": "proj-123"}'

# Start
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", "assigned_to": "invoice-agent"}'

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

Using Dependencies

When tasks must be completed in order, use dependencies:

# Task B depends on Task A
curl -X POST https://endpoint.acenta.ai/core/api/v1/tasks/{task_b_id}/dependencies \
  -H "Authorization: Bearer $ACENTA_KEY" \
  -H "Content-Type: application/json" \
  -d '{"depends_on": "{task_a_id}"}'

Agents can check whether blocking tasks are complete before starting work.

Handoff Notes via Comments

When an agent completes part of a task and hands off to another agent, leave 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": "Processed 47/50 invoices. 3 flagged for manual review in folder /invoices/flagged."}'

Monitoring with the Activity Log

Use the activity log to audit what happened to a task:

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

Next Steps

• Task Hub Concepts — Core concepts
• Tasks API — Complete API reference