Assign

Assign a new task

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

post

/tasks/assign

Body

idstringrequired

Example: task_001

descriptionstringrequired

Example: Optimize supply chain workflow for Q2

dueDatestring · date-time

Example: 2025-03-01T12:00:00Z

statusstring · enumrequired

Example: pending

Options: pending, in_progress, completed

metadataobject

Additional task details

taskMetricsobject

Execution metrics for the task

assignedEntityobject

Entity to which the task is assigned

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url 'https://infa.idefi.ai/api/tasks/assign' \
  --header 'Content-Type: application/json' \
  --data '{
    "id": "task_001",
    "description": "Optimize supply chain workflow for Q2",
    "dueDate": "2025-03-01T12:00:00Z",
    "status": "pending",
    "metadata": {
      "priority": "high",
      "notes": "Requires cross-functional team coordination"
    },
    "taskMetrics": {
      "estimatedDuration": 3600,
      "actualDuration": 3700,
      "resourceUsage": 75,
      "costEstimate": 150,
      "actualCost": 155
    },
    "assignedEntity": {
      "id": "agent_001",
      "type": "Agent"
    }
  }'

201

201

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

Task created and assigned