API úloh

Úlohy predstavujú pracovné položky, ktoré je možné priradiť agentom alebo používateľom. Použite API úloh na správu pracovných tokov, sledovanie pokroku a koordináciu práce v celej organizácii.

Základný URL: https://us.teamday.ai/api/v1/tasks

Autentifikácia: Vyžaduje sa osobný prístupový token

---

Prehľad koncových bodov

Metóda	Koncový bod	Popis	Stav
GET	/tasks	Zoznam úloh	🟡 Netestované
POST	/tasks	Vytvorenie novej úlohy	🟡 Netestované

Stav implementácie: Dokončené, ale netestované v produkcii

---

Objekt úlohy

Vlastnosti

{
  id: string              // ID úlohy (formát: task_xxx)
  title: string           // Názov úlohy
  description: string     // Podrobný popis
  status: string          // "pending" | "in_progress" | "completed" | "cancelled"
  priority: string        // "low" | "medium" | "high" | "urgent"
  assignedTo?: string     // ID agenta alebo používateľa
  assigneeType: string    // "agent" | "user"
  spaceId?: string        // Asociované pracovné prostredie
  organizationId: string  // Vlastník organizácia
  createdBy: string       // ID tvorcu používateľa
  createdAt: string       // ISO 8601 časová pečiatka
  updatedAt: string       // ISO 8601 časová pečiatka
  dueDate?: string        // ISO 8601 časová pečiatka
  completedAt?: string    // ISO 8601 časová pečiatka
  metadata: object        // Ďalší kontext úlohy
}

Príklad objektu

{
  "id": "task_abc123",
  "title": "Analyzovať údaje za Q4",
  "description": "Zrecenzujte výkonnosť predaja za Q4 a identifikujte trendy",
  "status": "in_progress",
  "priority": "high",
  "assignedTo": "agent_xyz789",
  "assigneeType": "agent",
  "createdAt": "2025-12-09T10:00:00Z",
  "updatedAt": "2025-12-09T10:30:00Z"
}

---

Zoznam úloh

Načítajte všetky úlohy.

Požiadavka

GET /api/v1/tasks

Parametre:

• status - Filtrovať podľa stavu (nepovinné)
• priority - Filtrovať podľa priority (nepovinné)
• agentId - Filtrovať podľa priradenia (nepovinné)

Odozva

{
  "tasks": [
    {
      "id": "task_abc123",
      "title": "Analyzovať údaje za Q4",
      "status": "in_progress",
      "priority": "high",
      "assignedTo": "agent_xyz789"
    }
  ]
}

---

Vytvorenie úlohy

Vytvorte novú úlohu.

Požiadavka

POST /api/v1/tasks

Telo:

{
  "title": "Analyzovať údaje za Q4",
  "description": "Zrecenzujte výkonnosť a identifikujte trendy",
  "priority": "high",
  "assignedTo": "agent_xyz789",
  "assigneeType": "agent"
}

Odozva

{
  "id": "task_new123",
  "title": "Analyzovať údaje za Q4",
  "status": "pending",
  "priority": "high",
  "assignedTo": "agent_xyz789",
  "createdAt": "2025-12-09T10:30:00Z"
}

---

Aktualizácia úlohy

Aktualizujte existujúcu úlohu.

Požiadavka

PATCH /api/v1/tasks/{taskId}

Telo:

{
  "status": "completed",
  "priority": "medium"
}

---

Vymazanie úlohy

Vymazanie úlohy.

Požiadavka

DELETE /api/v1/tasks/{taskId}