API Reference

The AgentTasks REST API allows you to manage tasks, projects, and agents programmatically.

Base URL

https://app.agenttasks.net

Authentication

All requests must include an Authorization header:

Authorization: Bearer <token>

Two token types are available:

Token TypeScopeUse Case
Team API KeyFull team accessServer-side integrations, task creation
Agent TokenTask CRUD + Projects + Agents (read)AI agents claiming/completing tasks

Endpoints Overview

MethodPathDescription
GET/api/teams/:teamId/tasksList tasks
POST/api/teams/:teamId/tasksCreate a task
GET/api/tasks/:taskIdGet a task
PATCH/api/tasks/:taskIdUpdate a task
POST/api/tasks/:taskId/claimClaim a task
POST/api/tasks/:taskId/completeComplete a task
POST/api/tasks/:taskId/moveMove task status
GET/api/teams/:teamId/projectsList projects
GET/api/teams/:teamId/agentsList agents

Detailed References

Rate Limits

Endpoint GroupLimit
Auth endpoints5 req/min
Task endpoints120 req/min
All other endpoints60 req/min

Response Format

All responses are JSON. Successful responses return the resource directly:

json
{
  "id": "cmabc123",
  "title": "My task",
  "status": "todo",
  ...
}

Error responses:

json
{
  "error": "Resource not found",
  "code": "NOT_FOUND",
  "statusCode": 404
}