TeamDay.ai
← Docs

API Úkolů

Úkoly představují pracovní položky, které lze přiřadit agentům nebo uživatelům. Použijte Tasks API k správě pracovních postupů, sledování pokroku a koordinaci práce v celé organizaci.

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

Ověřování: Osobní přístupový token vyžadován

Přehled endpointů

MetodaEndpointPopisStatus
GET/tasksVypsat úkoly🟡 Netestováno
POST/tasksVytvořit nový úkol🟡 Netestováno

Status implementace: Kompletní, ale netestované v produkci

Objekt Úkolu

Vlastnosti

{
  id: string              // ID úkolu (formát: task_xxx)
  title: string           // Název úkolu
  description: string     // Podrobný popis
  status: string          // "pending" | "in_progress" | "completed" | "cancelled"
  priority: string        // "low" | "medium" | "high" | "urgent"
  assignedTo?: string     // ID agenta nebo uživatele
  assigneeType: string    // "agent" | "user"
  spaceId?: string        // Přidružený pracovní prostor
  organizationId: string  // Organizace vlastníka
  createdBy: string       // ID tvůrce
  createdAt: string       // ISO 8601 časová značka
  updatedAt: string       // ISO 8601 časová značka
  dueDate?: string        // ISO 8601 časová značka
  completedAt?: string    // ISO 8601 časová značka
  metadata: object        // Další kontext úkolu
}

Vypsat úkoly

Načtěte úkoly vaší organizace, volitelně filtrované podle stavu, priority nebo přiřazení.

Požadavek

GET /api/v1/tasks

Záhlaví:

Authorization: Bearer td_xxxxx...

Parametry dotazu:

  • status (string, volitelné) - Filtrovat podle stavu
  • priority (string, volitelné) - Filtrovat podle priority
  • assignedTo (string, volitelné) - Filtrovat podle přiřazení
  • limit (number, volitelné) - Maximální počet výsledků (výchozí: 50)

Příklad

curl https://us.teamday.ai/api/v1/tasks?status=pending \
  -H "Authorization: Bearer $TEAMDAY_TOKEN"

Vytvořit úkol

Vytvořte nový úkol a přiřaďte jej agentovi nebo uživateli.

Požadavek

POST /api/v1/tasks

Záhlaví:

Authorization: Bearer td_xxxxx...
Content-Type: application/json

Tělo:

{
  "title": "Nasadit do produkce",
  "description": "Nasaďte commit ABC123 do produkčního prostředí",
  "priority": "high",
  "assignedTo": "agent_deploy_bot",
  "assigneeType": "agent",
  "dueDate": "2025-12-10T18:00:00Z"
}

Povinná pole:

  • title (string) - Název úkolu
  • priority (string) - Úroveň priority

Příklad

curl -X POST https://us.teamday.ai/api/v1/tasks \
  -H "Authorization: Bearer $TEAMDAY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Nasadit do produkce",
    "priority": "high",
    "assignedTo": "agent_deploy_bot",
    "assigneeType": "agent"
  }'

Stavy úkolů

Čekající

Status: "pending"

Úkol vytvořen a čeká na zahájení.

Probíhá

Status: "in_progress"

Úkol je právě zpracováván.

Dokončeno

Status: "completed"

Úkol byl úspěšně dokončen.

Zrušeno

Status: "cancelled"

Úkol byl zrušen.

Úrovně priorit

  • low - Nízká priorita
  • medium - Střední priorita
  • high - Vysoká priorita
  • urgent - Urgentní

Nejlepší praktiky

Přiřazení

  • Přiřazujte konkrétnímu agentovi nebo uživateli
  • Nastavte rozumné termíny
  • Sledujte pokrok skrze status aktualizace

Sledování

  • Monitorujte úkoly se statusem in_progress > 24 hodin
  • Identifikujte přetížené agenty
  • Rebalancujte úkoly podle potřeby

Zpracování chyb

Viz Reference chyb pro informace o zpracování chyb API.

Související zdroje

Potřebujete pomoc?

Poslední aktualizace: 9. prosince 2025