Tasks

A task is a natural language instruction that Miteos decomposes and executes via one or more agents.

Creating a Task

Submit a task via the War Room prompt bar or the API:

POST /tasks
{
  "prompt": "Research the top 5 SaaS competitors to Notion and create a feature comparison spreadsheet",
  "workspace_id": "optional-workspace-id"
}

Task Decomposition

Miteos automatically breaks complex tasks into subtasks:

"Research competitors and build a pricing dashboard"
├── Subtask 1: Research competitor pricing pages (researcher)
├── Subtask 2: Extract and structure pricing data (analyst)
└── Subtask 3: Build interactive dashboard component (builder)

Each subtask is assigned to the most appropriate agent type based on the required tools and capabilities.

Task States

State	Description
`pending`	Task created, waiting to start
`running`	Agents actively working
`completed`	All subtasks finished successfully
`failed`	One or more subtasks failed unrecoverably
`cancelled`	User cancelled the task

Monitoring

Track task progress in real-time:

GET /tasks/{task_id}

Returns:

{
  "id": "task-abc123",
  "prompt": "Research competitor pricing...",
  "status": "running",
  "total_tokens_used": 4521,
  "total_cost_cents": 2,
  "created_at": "2026-06-20T10:00:00Z",
  "subtasks": [
    {"id": "st-1", "agent_type": "researcher", "status": "complete"},
    {"id": "st-2", "agent_type": "analyst", "status": "running"},
    {"id": "st-3", "agent_type": "builder", "status": "pending"}
  ]
}

Cancellation

Cancel a running task (kills all active agents):

POST /tasks/{task_id}/cancel

Deliverables

When a task completes, its outputs are available as deliverables:

GET /tasks/{task_id}/deliverables

Each deliverable can be:

Downloaded as a file
Deployed to a staging URL
Shared via a public link

Task History

List all your tasks:

GET /tasks?limit=20&offset=0

Completed Tasks (for Skill Compiler)

Successfully completed tasks can be used to compile reusable skills:

GET /tasks/completed

The Skill Compiler analyzes the action patterns from successful tasks and extracts them into named, reusable skills that execute faster on repeat.

​Tasks

​Creating a Task

​Task Decomposition

​Task States

​Monitoring

​Cancellation

​Deliverables

​Task History

​Completed Tasks (for Skill Compiler)