18. API Create Task

1. API

Domain:

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

Headers

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

2. Parameters

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

Request Body

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": "[e-mail]",
  "priority": "NORMAL",
  "status": "DOING",
  "category": "Test",
  "dueAtType": 0,
  "timeComplete": 2,
  "timeUnitComplete": "hours",
  "contact": "[e-mail]"
}'

3. Response

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