Ramp: Edit a procurement request — request body — body
Edit a procurement request: request body, field body. Complete fields and constraints for contract 2026-10-27.
API reference · Contract 2026-10-27
SDK schema: Edit a procurement request — request body — body
| Field | Type | Presence | Description and constraints |
|---|---|---|---|
$ | object | Root | Sparse scalar edits and complete collection replacements for draft or submitted requests. Additional keys: not allowed |
accounting_field_selections | array | Optional | Complete replacement of request-level accounting selections: omit to preserve, unlisted enabled fields are cleared, [] clears all. |
accounting_field_selections[] | Model | Each item | Expand Edit a procurement request — request body — body accounting field selections item |
currency | Model | Optional | Expand Edit a procurement request — request body — body currency ISO 4217 currency code for the request. Omit to keep the saved value. |
end_date | JSON | Optional | |
end_date (anyOf 1) | string | Alternative | Spend period end, YYYY-MM-DD. Null clears it. Format: date |
end_date (anyOf 2) | null | Alternative | |
entity_id | string | Optional | ID of the business entity for the request. Omit to keep the saved value. Format: uuid |
field_answers | array | Optional | Complete replacement of API-editable answers. Omit to preserve answers; omitted supported field IDs are cleared, and [] clears all supported answers. Unexposed answers, including file uploads, are preserved. |
field_answers[] | JSON | Each item | discriminator: {“mapping”: {“address”: ”#/components/schemas/ApiAddressFieldAnswerRequestBody”, “boolean”: ”#/components/schemas/ApiBooleanFieldAnswerRequestBody”, “contact”: ”#/components/schemas/ApiContactFieldAnswerRequestBody”, “date”: ”#/components/schemas/ApiDateFieldAnswerRequestBody”, “department”: ”#/components/schemas/ApiDepartmentFieldAnswerRequestBody”, “email”: ”#/components/schemas/ApiEmailFieldAnswerRequestBody”, “link”: ”#/components/schemas/ApiLinkFieldAnswerRequestBody”, “merchant”: ”#/components/schemas/ApiMerchantFieldAnswerRequestBody”, “merchant_category”: ”#/components/schemas/ApiMerchantCategoryFieldAnswerRequestBody”, “monetary_amount”: ”#/components/schemas/ApiMonetaryAmountFieldAnswerRequestBody”, “multi_select”: ”#/components/schemas/ApiMultiSelectFieldAnswerRequestBody”, “number”: ”#/components/schemas/ApiNumberFieldAnswerRequestBody”, “paragraph”: ”#/components/schemas/ApiParagraphFieldAnswerRequestBody”, “single_select”: ”#/components/schemas/ApiSingleSelectFieldAnswerRequestBody”, “text”: ”#/components/schemas/ApiTextFieldAnswerRequestBody”, “user”: ”#/components/schemas/ApiUserFieldAnswerRequestBody”, “vendor”: ”#/components/schemas/ApiVendorFieldAnswerRequestBody”}, “propertyName”: “answer_type”} |
field_answers[] (oneOf 1) | Model | Alternative | Expand Edit a procurement request — request body — body field answers item answer type address |
field_answers[] (oneOf 2) | Model | Alternative | Expand Edit a procurement request — request body — body field answers item answer type boolean |
field_answers[] (oneOf 3) | Model | Alternative | Expand Edit a procurement request — request body — body field answers item answer type contact |
field_answers[] (oneOf 4) | Model | Alternative | Expand Edit a procurement request — request body — body field answers item answer type date |
field_answers[] (oneOf 5) | Model | Alternative | Expand Edit a procurement request — request body — body field answers item answer type department |
field_answers[] (oneOf 6) | Model | Alternative | Expand Edit a procurement request — request body — body field answers item answer type email |
field_answers[] (oneOf 7) | Model | Alternative | Expand Edit a procurement request — request body — body field answers item answer type link |
field_answers[] (oneOf 8) | Model | Alternative | Expand Edit a procurement request — request body — body field answers item answer type merchant category |
field_answers[] (oneOf 9) | Model | Alternative | Expand Edit a procurement request — request body — body field answers item answer type merchant |
field_answers[] (oneOf 10) | Model | Alternative | Expand Edit a procurement request — request body — body field answers item answer type monetary amount |
field_answers[] (oneOf 11) | Model | Alternative | Expand Edit a procurement request — request body — body field answers item answer type multi select |
field_answers[] (oneOf 12) | Model | Alternative | Expand Edit a procurement request — request body — body field answers item answer type number |
field_answers[] (oneOf 13) | Model | Alternative | Expand Edit a procurement request — request body — body field answers item answer type paragraph |
field_answers[] (oneOf 14) | Model | Alternative | Expand Edit a procurement request — request body — body field answers item answer type single select |
field_answers[] (oneOf 15) | Model | Alternative | Expand Edit a procurement request — request body — body field answers item answer type text |
field_answers[] (oneOf 16) | Model | Alternative | Expand Edit a procurement request — request body — body field answers item answer type user |
field_answers[] (oneOf 17) | Model | Alternative | Expand Edit a procurement request — request body — body field answers item answer type vendor |
line_items | array | Optional | Complete replacement set. Omit to preserve all lines; omitted existing IDs are deleted, and [] removes all source lines. Every item requires unit_price and unit_quantity. Omitted or null description clears it. Retained lines preserve unexposed metadata and omitted coding. |
line_items[] | Model | Each item | Expand Edit a procurement request — request body — body line items item |
name | string | Optional | Name of the request. Omit to keep the saved value. |
start_date | JSON | Optional | |
start_date (anyOf 1) | string | Alternative | Spend period start, YYYY-MM-DD. Null clears it. Format: date |
start_date (anyOf 2) | null | Alternative |
Referenced models: Edit a procurement request — request body — body accounting field selections item, Edit a procurement request — request body — body field answers item answer type address, Edit a procurement request — request body — body field answers item answer type boolean, Edit a procurement request — request body — body field answers item answer type contact, Edit a procurement request — request body — body field answers item answer type date, Edit a procurement request — request body — body field answers item answer type department, Edit a procurement request — request body — body field answers item answer type email, Edit a procurement request — request body — body field answers item answer type link, Edit a procurement request — request body — body field answers item answer type merchant category, Edit a procurement request — request body — body field answers item answer type merchant, Edit a procurement request — request body — body field answers item answer type monetary amount, Edit a procurement request — request body — body field answers item answer type multi select, Edit a procurement request — request body — body field answers item answer type number, Edit a procurement request — request body — body field answers item answer type paragraph, Edit a procurement request — request body — body line items item, Edit a procurement request — request body — body field answers item answer type single select, Edit a procurement request — request body — body field answers item answer type text, Edit a procurement request — request body — body field answers item answer type user, Edit a procurement request — request body — body field answers item answer type vendor, Edit a procurement request — request body — body currency