Ramp: Update a purchase order — request body — body
Update a purchase order: request body, field body. Complete fields and constraints for contract 2026-10-27.
API reference · Contract 2026-10-27
SDK schema: Update a purchase order — request body — body
| Field | Type | Presence | Description and constraints |
|---|---|---|---|
$ | object | Root | |
accounting_field_selections | array | Optional | List of accounting field options selected to code the purchase order at the body level. Will be updated in an ‘all or nothing’ manner. Generally, only a single vendor accounting field is supported. |
accounting_field_selections[] | Model | Each item | Expand Create a bill — request body — body accounting field selections item |
memo | JSON | Optional | |
memo (anyOf 1) | string | Alternative | Memo for the purchase order. |
memo (anyOf 2) | null | Alternative | |
name | JSON | Optional | |
name (anyOf 1) | string | Alternative | Name of the purchase order. Must contain a non-whitespace character. Omit to preserve the current name, or set to null to clear it. Pattern: \s*\S |
name (anyOf 2) | null | Alternative | |
owner_id | string | Optional | Unique identifier of the new owner of the purchase order. The purchase order must be approved. Format: uuid |
spend_end_date | string | Optional | The date when spending for this purchase order ends. Format: date |
spend_start_date | string | Optional | The date when spending for this purchase order begins. Format: date |
withholding_default_rate | JSON | Optional | |
withholding_default_rate (anyOf 1) | JSON | Alternative | Default retainage withholding rate for the purchase order, expressed as a fractional decimal. For example, 0.10 means 10%. Minimum: 0 Less than: 1 |
withholding_default_rate (anyOf 1) (oneOf 1) | string | Alternative | Format: decimal |
withholding_default_rate (anyOf 1) (oneOf 2) | number | Alternative | |
withholding_default_rate (anyOf 2) | null | Alternative |
Referenced models: Create a bill — request body — body accounting field selections item