---
title: "Add task artifact"
method: POST
path: "/shipping/orders/task_artifact/add/v1/{task_id}"
tags: ["/shipping/orders"]
---

# Add task artifact

`POST /shipping/orders/task_artifact/add/v1/{task_id}`

Adds a task artifact to an order task. Draft orders require draft_creator_org_operator and create DRAFT artifacts; operational orders require driver_for_executor, executor_org_operators, or coordinator_org_operators and create STAGED or COMPLETED artifacts. | authz_personas=[draft_creator_org_operator, driver_for_executor, executor_org_operators, coordinator_org_operators] | (OrdersAddTaskArtifactReq) -> (PydanticObjectId)

## Path parameters

- `task_id` string, required

## Request body

- OrdersAddTaskArtifactReq
  - `task_artifact` TaskArtifactClientCreate1, required
    - `schema_version` 1, required
    - `type` 'image' | 'signature' | 'scan' | 'other', required
    - `expected_scan_payloads` string[]
  - `status` 'staged' | 'completed', nullable — Initial status for a non-draft task artifact. Defaults to STAGED. Omit for draft orders.

## 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)