# 18. API Create Task

## 1. API

#### **Domain:**

Production: `POST https://apiring.antbuddy.com/tasks`

#### **Headers**

```json
{
  "apikey": "<secret key>",
  "Content-Type": "application/json"
}
```

## 2. Parameters

<table><thead><tr><th width="187.5999755859375">Tham số</th><th width="123.199951171875">Kiểu dữ liệu</th><th width="119.199951171875">Bắt buộc</th><th>Giải thích</th></tr></thead><tbody><tr><td><code>body</code></td><td>String</td><td>Y</td><td>Nội dung nhiệm vụ</td></tr><tr><td><code>assignTo</code></td><td>String</td><td>N</td><td>Email user trong org</td></tr><tr><td><code>group</code></td><td>String</td><td>N</td><td>Tên nhóm</td></tr><tr><td><code>priority</code></td><td>String</td><td>N</td><td><code>LOW</code> | <code>NORMAL</code> | <code>HIGH</code></td></tr><tr><td><code>status</code></td><td>Number</td><td>N</td><td><code>TO_DO</code> | <code>DOING</code> | <code>DONE</code> | <code>DEFERRED</code><br>• Nếu = <code>DONE</code> → sẽ set <code>isCompleted</code>, <code>completedAt</code>, <code>completedBy</code></td></tr><tr><td><code>category</code></td><td>String</td><td>N</td><td>Tên category</td></tr><tr><td><code>contact</code></td><td>String</td><td>N</td><td>Id, email hoặc số điện thoại</td></tr><tr><td><code>dueAtType</code></td><td>Number</td><td>N</td><td><p>Quy tắc tạo deadline (mili giây hoặc quy đổi từ đơn vị thời gian).</p><p><code>dueAtType</code> > 0: số mili giây cộng thêm từ hiện tại.</p><p></p><p><code>dueAtType</code> = 0: dùng <code>timeComplete</code> * <code>timeUnitComplete</code> <br>(<code>mins</code> | <code>hours</code> | <code>days</code>).</p></td></tr><tr><td><code>timeComplete</code></td><td>Number</td><td>N</td><td>Giá trị thời gian (khi <code>dueAtType = 0</code>)</td></tr><tr><td><code>timeUnitComplete</code></td><td>String</td><td>N</td><td><code>mins</code> | <code>hours</code> | <code>days</code></td></tr></tbody></table>

#### **Request Body**

```json
curl --request POST \
 --url https://apiring.antbuddy.com/tasks \
 --header 'Content-Type: application/json' \
 --header 'apikey: {{your-key}}' \
 --data '{
  "body": "Gọi lại khách lúc 11h chiều",
  "assignTo": "kanh@gm.co",
  "priority": "NORMAL",
  "status": "DOING",
  "category": "Test",
  "dueAtType": 0,
  "timeComplete": 2,
  "timeUnitComplete": "hours",
  "contact": "Q@gmail.com"
}'

```

## 3. Response

```json
{
  "success": true,
  "id": "69391ce48b0b13c6df860d02"
}
```