---
title: "Update custody parties"
method: PATCH
path: "/shipping/tasks/custody_parties/update/v1/{task_id}"
tags: ["/shipping/tasks"]
---

# Update custody parties

`PATCH /shipping/tasks/custody_parties/update/v1/{task_id}`

Updates or clears the parties that provided or received cargo for a task. Contact references must belong to the caller's organization. | authz_personas=[draft_creator_org_operator, driver_for_executor, executor_org_operators, coordinator_org_operators] (depending on status) | (TaskCustodyPartiesUpdateReq) -> (bool)

## Path parameters

- `task_id` string, required

## Request body

- TaskCustodyPartiesUpdateReq
  - `provided_by` CustodyParty1
    - `user_id` string, nullable — Must be a string starting with `user_`
    - `contact_id` string, nullable
    - `name` string, nullable
    - `note` string, nullable
  - `provided_by__set_to_None` boolean
  - `received_by` CustodyParty1
    - `user_id` string, nullable — Must be a string starting with `user_`
    - `contact_id` string, nullable
    - `name` string, nullable
    - `note` string, nullable
  - `received_by__set_to_None` boolean

## Response `200`

Successful Response

- boolean

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