작업

워크스페이스의 작업(task)을 읽는 조회 API입니다. 작업을 만들거나 바꾸는 엔드포인트는 없습니다.

목록 조회

GET /tasks — 워크스페이스 내 모든 팀의 활성 작업을 cursor pagination으로 조회합니다.

• Scope: tasks:read
• 쿼리: limit(기본 50, 1~100), cursor(이전 응답의 meta.next_cursor 값)
• 삭제된 작업(deleted_at)은 제외되며, created_at 내림차순으로 정렬됩니다.

범위를 벗어난 limit은 자동 보정 없이 400 INVALID_QUERY로 거부합니다. 발급 후 24시간이 지난 cursor도 같은 오류를 반환합니다. 자세한 규칙은 페이지네이션을 참고하세요.

아래 요청은 작업 50건을 조회합니다.

curl "https://api.talk.zeroworks.ai/api/public/v1/tasks?limit=50" \
  -H "Authorization: Bearer ztpat_..."

응답

{
  "success": true,
  "data": [
    {
      "id": "a1b2c3d4-...",
      "team_id": "7c8d9e0f-...",
      "title": "환불 문의 후속 처리",
      "description": "고객이 영수증을 추가로 보내기로 함",
      "channel_id": "c1d2e3f4-...",
      "status": "open",
      "assignee_id": "b2c3d4e5-...",
      "kind": "general",
      "due_at": "2026-05-03",
      "created_at": "2026-05-01T10:00:00Z",
      "updated_at": "2026-05-01T11:30:00Z"
    }
  ],
  "meta": { "has_more": true, "next_cursor": "eyJ..." }
}

필드

필드	타입	설명
id	string	작업 UUID
team_id	string	작업이 속한 팀 UUID. 팀에 속하지 않은 워크스페이스 작업에서는 키가 생략됩니다
title	string	작업 제목
description	string	작업 설명. 값이 없으면 키가 생략됩니다
channel_id	string	연결된 채널 UUID. 값이 없으면 키가 생략됩니다
status	string	open | in_progress | completed (이 세 값 외의 상태는 반환되지 않습니다)
assignee_id	string	담당자 UUID. 값이 없으면 키가 생략됩니다
kind	string	작업 종류. general(일반 작업) 또는 verdict(AI 답변 판정 요청)
due_at	string	마감일. "YYYY-MM-DD" 형식이며 값이 없으면 키가 생략됩니다
created_at·updated_at	string	RFC 3339 시각

team_id·description·channel_id·assignee_id·due_at은 값이 없으면 null이 아니라 키 자체가 생략됩니다 ("key" in obj로 판별).

단건 조회

GET /tasks/{id} — 단일 작업을 조회합니다. {id}는 작업 UUID입니다.

• Scope: tasks:read

아래 요청은 작업 한 건을 조회합니다.

curl "https://api.talk.zeroworks.ai/api/public/v1/tasks/a1b2c3d4-..." \
  -H "Authorization: Bearer ztpat_..."

응답 — 목록의 항목 하나와 같은 필드를 가집니다.

{
  "success": true,
  "data": {
    "id": "a1b2c3d4-...",
    "team_id": "7c8d9e0f-...",
    "title": "환불 문의 후속 처리",
    "status": "open",
    "kind": "general",
    "created_at": "2026-05-01T10:00:00Z",
    "updated_at": "2026-05-01T11:30:00Z"
  }
}

존재하지 않거나 삭제된 작업은 404 NOT_FOUND를 반환합니다.