Task

INFO

Har bir javob umumiy konvertda qaytadi — code, message, messages, status_code, time — foydali yuk esa data ichida. Quyidagi jadvallar faqat data ichini tavsiflaydi.

POST /task/create

Create a task. attached_to selects which FK array is required (trade_uuids/trade_ids, order_ids, customer_ids, supplier_ids, employee_ids).

So‘rov tanasi

Maydon	Tur	Majburiy	Tavsif
organization_id	string	Yo‘q
type_id	string	Ha	Task-type id (see /task-type/get-paging)
date	string (date-time)	Ha	Date the task is scheduled for. When time_type=range, the value is rewritten to start_of_day(date)+start_time using the boss's UTC offset.
time_type	string	Yo‘q	Mumkin qiymatlar: full_day, range. Standart: "full_day"
start_time	string	Yo‘q	Required when time_type=range. 24h HH:MM.
end_time	string	Yo‘q	Required when time_type=range. 24h HH:MM.
responsible_id	string	Ha
description	string	Yo‘q
attached_to	string	Yo‘q	Mumkin qiymatlar: trade, order, customer, supplier, employee
trade_uuids	string[]	Yo‘q	Used when attached_to=trade. Preferred over trade_ids; first non-empty wins.
trade_ids	string[]	Yo‘q	Used when attached_to=trade.
order_ids	string[]	Yo‘q	Required when attached_to=order.
customer_ids	string[]	Yo‘q	Required when attached_to=customer.
supplier_ids	string[]	Yo‘q	Required when attached_to=supplier.
employee_ids	string[]	Yo‘q	Required when attached_to=employee.

{
  "organization_id": "67b486d242ed76693cd2cc59",
  "type_id": "67b486d242ed76693cd2cc59",
  "date": "2023-10-01T12:00:00Z",
  "time_type": "full_day",
  "start_time": "09:00",
  "end_time": "10:30",
  "responsible_id": "67b486d242ed76693cd2cc59",
  "description": "string",
  "attached_to": "trade",
  "trade_uuids": [
    "string"
  ],
  "trade_ids": [
    "67b486d242ed76693cd2cc59"
  ],
  "order_ids": [
    "67b486d242ed76693cd2cc59"
  ],
  "customer_ids": [
    "67b486d242ed76693cd2cc59"
  ],
  "supplier_ids": [
    "67b486d242ed76693cd2cc59"
  ],
  "employee_ids": [
    "67b486d242ed76693cd2cc59"
  ]
}

Javob

Maydon	Tur	Tavsif
_id	string
created_at	string (date-time)
updated_at	string (date-time)
type_id	string
type	object
type._id	string
type.name	string
type.icon	string
type.svg	string
type.color	string
organization_id	string
date	string (date-time)
time_type	string	Mumkin qiymatlar: full_day, range
start_time	string
end_time	string
created_by	string
created_by_info	object
created_by_info._id	string
created_by_info.full_name	string
created_by_info.phone_number	string
responsible_id	string
responsible	object
responsible._id	string
responsible.full_name	string
responsible.phone_number	string
description	string
attached_to	string	Mumkin qiymatlar: trade, order, customer, supplier, employee
trade_ids	string[]
order_ids	string[]
customer_ids	string[]
supplier_ids	string[]
employee_ids	string[]
purchase_ids	string[]
state	string	Mumkin qiymatlar: created, completed
result_comment	string
is_postponed	boolean
postponed_id	string	On a postponed clone, points back to the original task.
completed_at	string (date-time)

{
  "code": 0,
  "message": "Success",
  "status_code": 200,
  "data": {
    "_id": "67b486d242ed76693cd2cc59",
    "created_at": "2025-05-01T12:00:00Z",
    "updated_at": "2025-05-01T12:00:00Z",
    "type_id": "67b486d242ed76693cd2cc59",
    "type": {
      "_id": "string",
      "name": "string",
      "icon": "string",
      "svg": "string",
      "color": "string"
    },
    "organization_id": "67b486d242ed76693cd2cc59",
    "date": "2025-05-01T12:00:00Z",
    "time_type": "full_day",
    "start_time": "09:00",
    "end_time": "10:30",
    "created_by": "67b486d242ed76693cd2cc59",
    "created_by_info": {
      "_id": "string",
      "full_name": "string",
      "phone_number": "string"
    },
    "responsible_id": "67b486d242ed76693cd2cc59",
    "responsible": {
      "_id": "string",
      "full_name": "string",
      "phone_number": "string"
    },
    "description": "string",
    "attached_to": "trade",
    "trade_ids": [
      "string"
    ],
    "order_ids": [
      "string"
    ],
    "customer_ids": [
      "string"
    ],
    "supplier_ids": [
      "string"
    ],
    "employee_ids": [
      "string"
    ],
    "purchase_ids": [
      "string"
    ],
    "state": "created",
    "result_comment": "string",
    "is_postponed": false,
    "postponed_id": "67b486d242ed76693cd2cc59",
    "completed_at": "2025-05-01T12:00:00Z"
  },
  "time": "2025-05-01T12:00:00Z"
}

PUT /task/update

Update a task. Rejects when state=completed. Only the creator or boss/additional-boss can update.

So‘rov tanasi

Maydon	Tur	Majburiy	Tavsif
_id	string	Ha
organization_id	string	Yo‘q
type_id	string	Yo‘q
date	string (date-time)	Yo‘q
time_type	string	Yo‘q	Mumkin qiymatlar: full_day, range
start_time	string	Yo‘q
end_time	string	Yo‘q
responsible_id	string	Yo‘q
description	string	Yo‘q
attached_to	string	Yo‘q	Mumkin qiymatlar: trade, order, customer, supplier, employee
trade_uuids	string[]	Yo‘q
trade_ids	string[]	Yo‘q
order_ids	string[]	Yo‘q
customer_ids	string[]	Yo‘q
supplier_ids	string[]	Yo‘q
employee_ids	string[]	Yo‘q

{
  "_id": "67b486d242ed76693cd2cc59",
  "organization_id": "67b486d242ed76693cd2cc59",
  "type_id": "67b486d242ed76693cd2cc59",
  "date": "2023-10-01T12:00:00Z",
  "time_type": "full_day",
  "start_time": "09:00",
  "end_time": "10:30",
  "responsible_id": "67b486d242ed76693cd2cc59",
  "description": "string",
  "attached_to": "trade",
  "trade_uuids": [
    "string"
  ],
  "trade_ids": [
    "string"
  ],
  "order_ids": [
    "string"
  ],
  "customer_ids": [
    "string"
  ],
  "supplier_ids": [
    "string"
  ],
  "employee_ids": [
    "string"
  ]
}

Javob

Javob tuzilishi quyidagi bilan bir xil: POST /task/create.

GET /task/get-by-id/{id}

Get a task by _id.

Yo‘l parametrlari

Parametr	Tur	Majburiy	Tavsif
id	string	Ha

So‘rov tanasi

So‘rov tanasi talab qilinmaydi.

Javob

Javob tuzilishi quyidagi bilan bir xil: POST /task/create.

GET /task/paging

Paginated task list. By default hides completed tasks unless state is set or date_type=completed_at. time and times filter by date-buckets (overdue/today/tomorrow/week/month/future) using the boss's UTC offset.

So‘rov parametrlari

Parametr	Tur	Majburiy	Tavsif
page	integer	Ha	Standart: 1
limit	integer	Ha	Standart: 20
updated_at	string (date-time)	Yo‘q	Sync cursor — only returns rows with updated_at >= this value.
search	string	Yo‘q
time	string	Yo‘q	Mumkin qiymatlar: overdue, today, tomorrow, week, month, future
times	string[]	Yo‘q
date_type	string	Yo‘q	Mumkin qiymatlar: created_at, date, completed_at
responsible_id	string	Yo‘q
type_id	string	Yo‘q
type_ids	string[]	Yo‘q
attached_to	string	Yo‘q	Mumkin qiymatlar: trade, order, customer, supplier, employee
state	string	Yo‘q	Mumkin qiymatlar: created, completed
trade_id	string	Yo‘q
order_id	string	Yo‘q
customer_id	string	Yo‘q
supplier_id	string	Yo‘q
employee_id	string	Yo‘q
purchase_id	string	Yo‘q
organization_id	string	Yo‘q

So‘rov tanasi

So‘rov tanasi talab qilinmaydi.

Javob

data.total — jami yozuvlar soni, data.data[] — joriy sahifadagi yozuvlar. Quyidagi jadval bitta yozuvni tavsiflaydi.

Maydon	Tur	Tavsif
_id	string
created_at	string (date-time)
updated_at	string (date-time)
type_id	string
type	object
type._id	string
type.name	string
type.icon	string
type.svg	string
type.color	string
organization_id	string
date	string (date-time)
time_type	string	Mumkin qiymatlar: full_day, range
start_time	string
end_time	string
created_by	string
created_by_info	object
created_by_info._id	string
created_by_info.full_name	string
created_by_info.phone_number	string
responsible_id	string
responsible	object
responsible._id	string
responsible.full_name	string
responsible.phone_number	string
description	string
attached_to	string	Mumkin qiymatlar: trade, order, customer, supplier, employee
trade_ids	string[]
order_ids	string[]
customer_ids	string[]
supplier_ids	string[]
employee_ids	string[]
purchase_ids	string[]
state	string	Mumkin qiymatlar: created, completed
result_comment	string
is_postponed	boolean
postponed_id	string	On a postponed clone, points back to the original task.
completed_at	string (date-time)

{
  "code": 0,
  "message": "Success",
  "status_code": 200,
  "data": {
    "total": 0,
    "data": [
      {
        "_id": "67b486d242ed76693cd2cc59",
        "created_at": "2025-05-01T12:00:00Z",
        "updated_at": "2025-05-01T12:00:00Z",
        "type_id": "67b486d242ed76693cd2cc59",
        "type": {
          "_id": "string",
          "name": "string",
          "icon": "string",
          "svg": "string",
          "color": "string"
        },
        "organization_id": "67b486d242ed76693cd2cc59",
        "date": "2025-05-01T12:00:00Z",
        "time_type": "full_day",
        "start_time": "09:00",
        "end_time": "10:30",
        "created_by": "67b486d242ed76693cd2cc59",
        "created_by_info": {
          "_id": "string",
          "full_name": "string",
          "phone_number": "string"
        },
        "responsible_id": "67b486d242ed76693cd2cc59",
        "responsible": {
          "_id": "string",
          "full_name": "string",
          "phone_number": "string"
        },
        "description": "string",
        "attached_to": "trade",
        "trade_ids": [
          "string"
        ],
        "order_ids": [
          "string"
        ],
        "customer_ids": [
          "string"
        ],
        "supplier_ids": [
          "string"
        ],
        "employee_ids": [
          "string"
        ],
        "purchase_ids": [
          "string"
        ],
        "state": "created",
        "result_comment": "string",
        "is_postponed": false,
        "postponed_id": "67b486d242ed76693cd2cc59",
        "completed_at": "2025-05-01T12:00:00Z"
      }
    ]
  },
  "time": "2025-05-01T12:00:00Z"
}

DELETE /task/delete/{id}

Soft-delete a task (sets is_deleted=true). Rejects when state=completed.

Yo‘l parametrlari

Parametr	Tur	Majburiy	Tavsif
id	string	Ha

So‘rov tanasi

So‘rov tanasi talab qilinmaydi.

Javob

{
  "code": 0,
  "message": "Success",
  "status_code": 200,
  "data": "67b486d242ed76693cd2cc59",
  "time": "2025-05-01T12:00:00Z"
}

GET /task/get-deleted

Returns ids of tasks deleted on or after deleted_at (also matches updated_at >= deleted_at).

So‘rov parametrlari

Parametr	Tur	Majburiy	Tavsif
deleted_at	string (date-time)	Ha

So‘rov tanasi

So‘rov tanasi talab qilinmaydi.

Javob

{
  "code": 0,
  "message": "Success",
  "status_code": 200,
  "data": [
    "string"
  ],
  "time": "2025-05-01T12:00:00Z"
}

PUT /task/complete

Mark a task as completed. Set is_postponed=true with postponed_date to clone the task at a future date (the original is marked completed; the clone has postponed_id pointing back to it).

So‘rov tanasi

Maydon	Tur	Majburiy	Tavsif
_id	string	Ha
result_comment	string	Yo‘q
is_postponed	boolean	Yo‘q	Standart: false
postponed_date	string (date-time)	Yo‘q	Required when is_postponed=true. Must be in the future. The original task is marked completed and a clone with postponed_id pointing to the original is created at this date.

{
  "_id": "67b486d242ed76693cd2cc59",
  "result_comment": "string",
  "is_postponed": false,
  "postponed_date": "2023-10-01T12:00:00Z"
}

Javob

Javob tuzilishi quyidagi bilan bir xil: POST /task/create.

PUT /task/move

Move a task into a time-frame bucket. Sets date to the bucket's start (today/tomorrow/week/month) or month_end+1s for future. overdue is rejected.

So‘rov tanasi

Maydon	Tur	Majburiy	Tavsif
_id	string	Ha
time	string	Ha	Target time-frame bucket. overdue is rejected.. Mumkin qiymatlar: today, tomorrow, week, month, future

{
  "_id": "67b486d242ed76693cd2cc59",
  "time": "today"
}

Javob

Javob tuzilishi quyidagi bilan bir xil: POST /task/create.

---

Bu sahifa OpenAPI spetsifikatsiyasidan yaratilgan.