---
title: "POST /holds"
method: POST
path: "/holds"
---

# POST /holds

`POST /holds`

## Request body

- object
  - `target_id` string, required — The ID of the Payment Order
  - `target_type` 'payment_order', required — Must be `payment_order`
  - `reason` string — Free-form contextual information about the hold
  - `metadata` string, json

## Response `200`

- object
  - `id` string
  - `target_id` string
  - `target_type` string
  - `reason` string
  - `resolution` string
  - `resolved_at` string, date-time
  - `created_at` string, date-time
  - `updated_at` string, date-time
  - `metadata` string, json

---

[API](https://skmtc.net/modern-treasury/apis/modern-treasury-api.md) · [All operations](https://skmtc.net/modern-treasury/apis/modern-treasury-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/modern-treasury/modern-treasury-api/versions/ed0431a2dcd0/schema)