跳到主要内容

Task Endpoints

API endpoints for task management, statuses, priorities, and related features.

Tasks​

List Tasks​

GET /api/tasks?take=20&skip=0&relations[]=project&relations[]=creator
Authorization: Bearer {token}

Response (200 OK):

{
  "items": [
    {
      "id": "...",
      "title": "Implement user dashboard",
      "description": "Create the main dashboard view",
      "number": 42,
      "prefix": "PROJ",
      "status": "IN_PROGRESS",
      "priority": "HIGH",
      "size": "MEDIUM",
      "estimate": 28800,
      "dueDate": "2024-02-01T00:00:00.000Z",
      "projectId": "...",
      "organizationId": "...",
      "creator": { "id": "...", "name": "John Doe" },
      "tags": [{ "name": "Frontend" }],
      "taskStatusId": "...",
      "taskPriorityId": "...",
      "taskSizeId": "..."
    }
  ],
  "total": 150
}

Get Task by ID​

GET /api/tasks/{id}?relations[]=members&relations[]=teams
Authorization: Bearer {token}

Create Task​

POST /api/tasks
Authorization: Bearer {token}
Content-Type: application/json

{
  "title": "New Feature Task",
  "description": "Implement the new feature",
  "status": "TODO",
  "priority": "MEDIUM",
  "size": "LARGE",
  "estimate": 57600,
  "dueDate": "2024-02-15",
  "projectId": "project-uuid",
  "organizationId": "org-uuid",
  "members": [{ "id": "employee-uuid" }],
  "tags": [{ "id": "tag-uuid" }]
}

Update Task​

PUT /api/tasks/{id}
Authorization: Bearer {token}
Content-Type: application/json

{
  "title": "Updated Task Title",
  "status": "IN_PROGRESS",
  "priority": "HIGH"
}

Delete Task​

DELETE /api/tasks/{id}
Authorization: Bearer {token}

Task Statuses​

List Statuses​

GET /api/tasks/statuses?where[projectId]={project-id}
Authorization: Bearer {token}

Default Statuses: OPEN, IN_PROGRESS, READY_FOR_REVIEW, IN_REVIEW, BLOCKED, DONE

Create Custom Status​

POST /api/tasks/statuses
Authorization: Bearer {token}
Content-Type: application/json

{
  "name": "QA Testing",
  "value": "qa-testing",
  "icon": "checkmark-circle-outline",
  "color": "#FFA500",
  "order": 5,
  "projectId": "project-uuid",
  "organizationId": "org-uuid"
}

Task Priorities​

List Priorities​

GET /api/tasks/priorities
Authorization: Bearer {token}

Default Priorities: URGENT, HIGH, MEDIUM, LOW

Create Custom Priority​

POST /api/tasks/priorities
Authorization: Bearer {token}
Content-Type: application/json

{
  "name": "Critical",
  "value": "critical",
  "icon": "alert-triangle-outline",
  "color": "#FF0000",
  "organizationId": "org-uuid"
}

Task Sizes​

List Sizes​

GET /api/tasks/sizes
Authorization: Bearer {token}

Default Sizes: X_LARGE, LARGE, MEDIUM, SMALL, TINY

Issue Types​

List Issue Types​

GET /api/tasks/issue-types
Authorization: Bearer {token}

Default Types: BUG, STORY, TASK, EPIC

Task Views​

Daily Board View​

GET /api/tasks/daily?date=2024-01-15&employeeId={id}
Authorization: Bearer {token}

Team Tasks​

GET /api/tasks/team?where[organizationTeamId]={team-id}
Authorization: Bearer {token}

My Tasks​

GET /api/tasks/employee/{employee-id}
Authorization: Bearer {token}

Sprint Management​

List Sprints​

GET /api/organization-sprint?where[projectId]={project-id}
Authorization: Bearer {token}

Create Sprint​

POST /api/organization-sprint
Authorization: Bearer {token}
Content-Type: application/json

{
  "name": "Sprint 1",
  "projectId": "project-uuid",
  "startDate": "2024-01-15",
  "endDate": "2024-01-29",
  "goal": "Complete dashboard features",
  "organizationId": "org-uuid"
}

Goals & KPIs​

List Goals​

GET /api/goals
Authorization: Bearer {token}

Create Goal​

POST /api/goals
Authorization: Bearer {token}
Content-Type: application/json

{
  "name": "Q1 Revenue Target",
  "deadline": "END_OF_QUARTER",
  "level": "ORGANIZATION",
  "organizationId": "org-uuid"
}

Key Results​

GET /api/key-results?where[goalId]={goal-id}
Authorization: Bearer {token}