Assign

Assign a new task

post

Creates and assigns a new task to an entity (agent, squad, syndicate, or marketplace item) with detailed execution metrics.

Body

idstringRequiredExample: task_001

descriptionstringRequiredExample: Optimize supply chain workflow for Q2

statusstring · enumRequiredExample: pendingPossible values:

dueDatestring · date-timeOptionalExample: 2025-03-01T12:00:00Z

Responses

201

Task created and assigned

application/json

post

HTTPcURLJavaScriptPython

POST /api/tasks/assign HTTP/1.1
Host: infa.idefi.ai
Content-Type: application/json
Accept: */*
Content-Length: 377

{
  "id": "task_001",
  "description": "Optimize supply chain workflow for Q2",
  "assignedEntity": {
    "type": "Agent",
    "id": "agent_001"
  },
  "status": "pending",
  "dueDate": "2025-03-01T12:00:00Z",
  "metadata": {
    "priority": "high",
    "notes": "Requires cross-functional team coordination"
  },
  "taskMetrics": {
    "estimatedDuration": 3600,
    "actualDuration": 3700,
    "resourceUsage": 75,
    "costEstimate": 150,
    "actualCost": 155
  }
}

201

Task created and assigned

{
  "id": "task_003",
  "description": "Launch new marketing campaign",
  "assignedEntity": {
    "type": "Squad",
    "id": "squad_002"
  },
  "status": "pending",
  "dueDate": "2025-04-01T08:00:00Z",
  "metadata": {
    "priority": "medium",
    "notes": "Focus on social channels"
  },
  "taskMetrics": {
    "estimatedDuration": 7200,
    "resourceUsage": 80,
    "costEstimate": 200
  }
}