Managing Tasks

curl --request GET \
  --url 'https://api.connecteam.com/tasks/v1/taskboards/12345/tasks?status=published&limit=50' \
  --header 'X-API-KEY: YOUR_API_KEY'

{
  "requestId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "data": {
    "tasks": [
      {
        "id": "task-abc123",
        "title": "Complete safety inspection",
        "userIds": [9170357, 9170358],
        "status": "published",
        "type": "oneTime",
        "startTime": 1704110400,
        "dueDate": 1704196800,
        "labelIds": ["label-123", "label-456"],
        "isArchived": false,
        "subTasks": [
          {
            "id": "subtask-001",
            "title": "Check fire extinguishers",
            "isCompleted": true
          },
          {
            "id": "subtask-002",
            "title": "Inspect emergency exits",
            "isCompleted": false
          }
        ],
        "description": [
          {
            "type": "html",
            "html": "<p>Monthly safety inspection checklist</p>"
          }
        ]
      }
    ]
  },
  "paging": {
    "offset": 1
  }
}

curl --request POST \
  --url https://api.connecteam.com/tasks/v1/taskboards/12345/tasks \
  --header 'Content-Type: application/json' \
  --header 'X-API-KEY: YOUR_API_KEY' \
  --data '{
    "title": "Complete onboarding checklist",
    "userIds": [9170357],
    "status": "published",
    "dueDate": 1704196800,
    "labelIds": ["label-onboarding"],
    "subTasks": [
      { "title": "Read employee handbook" },
      { "title": "Complete HR forms" },
      { "title": "Setup workstation" }
    ],
    "description": {
      "content": "Welcome! Please complete all items before your first week ends."
    }
  }'

curl --request POST \
  --url https://api.connecteam.com/tasks/v1/taskboards/12345/tasks \
  --header 'Content-Type: application/json' \
  --header 'X-API-KEY: YOUR_API_KEY' \
  --data '{
    "title": "Quarterly review template",
    "userIds": [],
    "status": "draft",
    "description": {
      "content": "Template for Q1 reviews - assign to managers when ready"
    }
  }'

curl --request POST \
  --url https://api.connecteam.com/tasks/v1/taskboards/12345/tasks \
  --header 'Content-Type: application/json' \
  --header 'X-API-KEY: YOUR_API_KEY' \
  --data '{
    "title": "Review training materials",
    "userIds": [9170357],
    "status": "published",
    "description": {
      "content": "Please review the attached training document",
      "attachments": [
        { "fileId": "file-training-doc-123" }
      ]
    }
  }'

curl --request PUT \
  --url https://api.connecteam.com/tasks/v1/taskboards/12345/tasks/task-abc123 \
  --header 'Content-Type: application/json' \
  --header 'X-API-KEY: YOUR_API_KEY' \
  --data '{
    "title": "Complete safety inspection",
    "userIds": [9170357],
    "status": "completed"
  }'

curl --request PUT \
  --url https://api.connecteam.com/tasks/v1/taskboards/12345/tasks/task-abc123 \
  --header 'Content-Type: application/json' \
  --header 'X-API-KEY: YOUR_API_KEY' \
  --data '{
    "title": "Complete safety inspection",
    "userIds": [9170358, 9170359],
    "status": "published"
  }'

curl --request DELETE \
  --url https://api.connecteam.com/tasks/v1/taskboards/12345/tasks/task-abc123 \
  --header 'X-API-KEY: YOUR_API_KEY'

{
  "requestId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "data": {}
}

class TaskManager {
  constructor(apiKey, taskBoardId) {
    this.apiKey = apiKey;
    this.taskBoardId = taskBoardId;
    this.baseUrl = `https://api.connecteam.com/tasks/v1/taskboards/${taskBoardId}/tasks`;
  }

  async createTask(title, userIds, options = {}) {
    const response = await fetch(this.baseUrl, {
      method: 'POST',
      headers: {
        'X-API-KEY': this.apiKey,
        'Content-Type': 'application/json'
      },
      body: JSON.stringify({
        title,
        userIds,
        status: options.status || 'published',
        dueDate: options.dueDate,
        labelIds: options.labelIds || [],
        subTasks: options.subTasks || [],
        description: options.description
      })
    });
    return response.json();
  }

  async completeTask(taskId) {
    const task = await this.getTask(taskId);
    return this.updateTask(taskId, { ...task, status: 'completed' });
  }

  async assignToNewUsers(taskId, newUserIds) {
    const task = await this.getTask(taskId);
    return this.updateTask(taskId, { ...task, userIds: newUserIds });
  }
}

// Usage
const tasks = new TaskManager('YOUR_API_KEY', 12345);
await tasks.createTask('Weekly report', [9170357], {
  dueDate: Math.floor(Date.now() / 1000) + 86400 * 7,
  subTasks: [
    { title: 'Gather metrics' },
    { title: 'Write summary' },
    { title: 'Submit for review' }
  ]
});

{
  "detail": "Task not found"
}

{
  "detail": "File not found, file_id: file-invalid"
}

{
  "detail": "File upload process not completed for file_id: file-123"
}