---
title: "Add task"
method: POST
path: "/shipping/orders/task/add/v1"
tags: ["/shipping/orders"]
---

# Add task

`POST /shipping/orders/task/add/v1`

Adds a task to an order task group. Draft tasks default to append and DRAFT status; operational tasks require an index and STAGED or COMPLETED status. | (OrdersAddTaskReq) -> (PydanticObjectId)

## Request body

- OrdersAddTaskReq
  - `task_group_id` string, required
  - `task` TaskClientCreate1, required — unresolved $ref
  - `cargo_ids` string[]
  - `status` 'draft' | 'staged' | 'completed' | 'skipped' | 'attempt' | 'cancelled' | 'exception'
  - `index` integer, nullable

## Response `200`

Successful Response

- string

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/chrt/apis/chrt-fastapi.md) · [All operations](https://skmtc.dev/chrt/apis/chrt-fastapi/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/chrt/chrt-fastapi/revisions/ea04e157edb3/schema)