Tasks API

The Tasks API provides endpoints for managing tasks, projects, dependencies, comments, and activity logs.

Base URL: https://endpoint.acenta.ai/core/api/v1

Projects

List projects

GET /projects

Create project

POST /projects

Field	Type	Required	Description
name	string	yes	Project name
description	string	no	Project description

Get project

GET /projects/{id}

Update project

PUT /projects/{id}

Delete project

DELETE /projects/{id}

Tasks

List tasks

GET /tasks

Query parameters: project_id, status, assigned_to, limit, offset

curl "https://endpoint.acenta.ai/core/api/v1/tasks?status=todo&project_id=proj-1" \
  -H "Authorization: Bearer $ACENTA_KEY"

Create task

POST /tasks

Field	Type	Required	Description
title	string	yes	Task title
description	string	no	Task description
status	string	yes	todo, in_progress, or done
project_id	string	no	Parent project
assigned_to	string	no	Agent ID
priority	string	no	low, medium, high
due_at	string	no	Due date (ISO 8601)

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-1"}'

Get task

GET /tasks/{id}

Update task

PATCH /tasks/{id}

Accepts any subset of task fields.

Delete task

DELETE /tasks/{id}

Dependencies

Add dependency

POST /tasks/{id}/dependencies

Field	Type	Required	Description
depends_on	string	yes	ID of the blocking task

Remove dependency

DELETE /tasks/{id}/dependencies/{dep_id}

Comments

List comments

GET /tasks/{id}/comments

Add comment

POST /tasks/{id}/comments

Field	Type	Required	Description
content	string	yes	Comment text

Activity Log

Get activity

GET /tasks/{id}/activity

Returns a chronological list of all state changes, assignments, and comments for the task.