Ramp: Update a vendor agreement
Ramp vendor.patchVendorAgreementResource: arguments, response, policy and SDK examples.
← Vendor operations · Get started
Operation ramp.patch_vendor_agreement_resource
Provider route: PATCH /developer/v1/vendors/agreements/{agreement_id}. Alter supplies the connection’s credentials and routing.
Call through Alter
Section titled “Call through Alter”Install @alter-ai/sdk @alter-ai/ramp with npm, or alter-sdk-ramp with pip. Supply your connected customer’s grant ID and the arguments described below.
import { App } from "@alter-ai/sdk";import { RampIntegration } from "@alter-ai/ramp";
async function execute(input: Parameters<RampIntegration["vendor"]["patchVendorAgreementResource"]>[0]) { const app = new App({ apiKey: process.env.ALTER_API_KEY! }); try { const provider = new RampIntegration(app, { grantId: process.env.PROVIDER_GRANT_ID! }); const call = await provider.vendor.patchVendorAgreementResource(input); const result = await call.wait(); return result.bodyJson(); } finally { await app.close(); }}import osfrom alter_sdk import Appfrom alter_sdk_ramp import RampIntegration
async def execute(arguments): async with App(api_key=os.environ["ALTER_API_KEY"]) as app: provider = RampIntegration(app, {"grant_id": os.environ["PROVIDER_GRANT_ID"]}) call = await provider.vendor.patch_vendor_agreement_resource(arguments) result = await call.wait() return result.body_json()| Field | Type | Presence | Description and constraints |
|---|---|---|---|
$ | object | Root | Additional keys: not allowed |
path | object | Required within parent | Additional keys: not allowed |
path.agreement_id | string | Required within parent | |
body | Model | Required within parent | Expand Update a vendor agreement — request body — body |
Referenced models: Update a vendor agreement — request body — body
Response
Section titled “Response”Response media type: application/json. The table describes the pinned successful response. Referenced models link to their complete fields.
| Field | Type | Presence | Description and constraints |
|---|---|---|---|
$ | Model | Root | Expand Fetch a vendor agreement — response body |
Referenced models: Fetch a vendor agreement — response body
Schemas
Section titled “Schemas”60 more schemas are linked from the tables above, on the schema pages.
Update a vendor agreement — request body — body
| Field | Type | Presence | Description and constraints |
|---|---|---|---|
$ | object | Root | |
auto_renewal | boolean | Optional | Whether the agreement automatically renews. |
contract_owner_ids | array | Optional | List of contract owner user IDs. |
contract_owner_ids[] | string | Each item | Format: uuid |
description | JSON | Optional | |
description (anyOf 1) | string | Alternative | Description of the vendor agreement. |
description (anyOf 2) | null | Alternative | |
end_date | JSON | Optional | |
end_date (anyOf 1) | string | Alternative | End date of the agreement. Format: date |
end_date (anyOf 2) | null | Alternative | |
last_date_to_terminate | JSON | Optional | |
last_date_to_terminate (anyOf 1) | string | Alternative | Last date by which the agreement can be terminated. Format: date |
last_date_to_terminate (anyOf 2) | null | Alternative | |
name | string | Optional | Name of the vendor agreement. Minimum length: 1 |
notifications_on | boolean | Optional | Whether notifications are enabled for this agreement. |
renewal_action | Model | Optional | Expand Update a vendor agreement — request body — body renewal action Renewal action update payload. Supported types are ACTIVE, RENEWED, and CANCELLED. Schema name: ApiVendorAgreementRenewalActionInput |
renewal_notification_settings | JSON | Optional | |
renewal_notification_settings (anyOf 1) | Model | Alternative | Expand Create a vendor agreement — request body — body renewal notification settings notification triggers, recipient approval group uuids, recipient dynamic user group uuids, recipient user uuids, recurring settings, scheduled enabled, should notify contract owner managers Notification settings to apply to this agreement. |
renewal_notification_settings (anyOf 2) | null | Alternative | |
renewal_notification_snooze | JSON | Optional | |
renewal_notification_snooze (anyOf 1) | Model | Alternative | Expand Update a vendor agreement — request body — body renewal notification snooze value Renewal notification snooze configuration. Deprecated: use renewal_notification_snoozed_until. Schema name: ApiVendorAgreementRenewalNotificationSnoozeInput |
renewal_notification_snooze (anyOf 2) | null | Alternative | |
renewal_notification_snoozed_until | JSON | Optional | |
renewal_notification_snoozed_until (anyOf 1) | string | Alternative | Date when renewal reminders resume. Must be after today and at most one year from today Date when renewal reminders resume. Must be after today and at most one year from today. Null ends an active snooze. Format: date Schema name: ApiVendorAgreementRenewalNotificationSnoozeDate |
renewal_notification_snoozed_until (anyOf 2) | null | Alternative | |
start_date | string | Optional | Start date of the agreement. Format: date |
total_value | Model | Optional | Expand Create a vendor agreement — request body — body total value Total monetary value of the agreement. |
Referenced models: Create a vendor agreement — request body — body total value, Create a vendor agreement — request body — body renewal notification settings notification triggers, recipient approval group uuids, recipient dynamic user group uuids, recipient user uuids, recurring settings, scheduled enabled, should notify contract owner managers, Update a vendor agreement — request body — body renewal action, Update a vendor agreement — request body — body renewal notification snooze value
Create a vendor agreement — request body — body total value
| Field | Type | Presence | Description and constraints |
|---|---|---|---|
$ | object | Root | |
amount | integer | Required within parent | Monetary amount in the currency's minor unit. |
currency_code | Model | Optional | Expand Edit a procurement request — request body — body currency Three-letter ISO currency code for the amount. Default: USD |
Referenced models: Edit a procurement request — request body — body currency
Create a vendor agreement — request body — body renewal notification settings notification triggers, recipient approval group uuids, recipient dynamic user group uuids, recipient user uuids, recurring settings, scheduled enabled, should notify contract owner managers
| Field | Type | Presence | Description and constraints |
|---|---|---|---|
$ | object | Root | Complete notification configuration used by create, merge, and the developer API. Omitted or null fields take their empty/false defaults; omitted or null ``recurring_settings`` disables recurrence. Omitted or null ``scheduled_enabled`` keeps the replaced group's value (true for new groups). |
notification_triggers | JSON | Optional | |
notification_triggers (anyOf 1) | array | Alternative | Default: null |
notification_triggers (anyOf 1)[] | Model | Each item | Expand Create a vendor agreement — request body — body renewal notification settings notification triggers, recipient approval group uuids, recipient dynamic user group uuids, recipient user uuids, recurring settings, scheduled enabled, should notify contract owner managers notification triggers array item |
notification_triggers (anyOf 2) | null | Alternative | |
recipient_approval_group_uuids | JSON | Optional | |
recipient_approval_group_uuids (anyOf 1) | array | Alternative | Default: null |
recipient_approval_group_uuids (anyOf 1)[] | string | Each item | |
recipient_approval_group_uuids (anyOf 2) | null | Alternative | |
recipient_dynamic_user_group_uuids | JSON | Optional | |
recipient_dynamic_user_group_uuids (anyOf 1) | array | Alternative | Default: null |
recipient_dynamic_user_group_uuids (anyOf 1)[] | string | Each item | |
recipient_dynamic_user_group_uuids (anyOf 2) | null | Alternative | |
recipient_user_uuids | JSON | Optional | |
recipient_user_uuids (anyOf 1) | array | Alternative | Default: null |
recipient_user_uuids (anyOf 1)[] | string | Each item | |
recipient_user_uuids (anyOf 2) | null | Alternative | |
recurring_settings | JSON | Optional | |
recurring_settings (anyOf 1) | Model | Alternative | Expand Create a vendor agreement — request body — body renewal notification settings notification triggers, recipient approval group uuids, recipient dynamic user group uuids, recipient user uuids, recurring settings, scheduled enabled, should notify contract owner managers recurring settings Complete recurring reminder configuration Complete recurring configuration; omission or null disables recurrence. Default: null |
recurring_settings (anyOf 2) | null | Alternative | |
scheduled_enabled | JSON | Optional | |
scheduled_enabled (anyOf 1) | boolean | Alternative | Pauses scheduled reminders when false; null preserves the current value. Default: null |
scheduled_enabled (anyOf 2) | null | Alternative | |
should_notify_contract_owner_managers | boolean | Optional | Default: false |
Referenced models: Create a vendor agreement — request body — body renewal notification settings notification triggers, recipient approval group uuids, recipient dynamic user group uuids, recipient user uuids, recurring settings, scheduled enabled, should notify contract owner managers notification triggers array item, Create a vendor agreement — request body — body renewal notification settings notification triggers, recipient approval group uuids, recipient dynamic user group uuids, recipient user uuids, recurring settings, scheduled enabled, should notify contract owner managers recurring settings Complete recurring reminder configuration
Update a vendor agreement — request body — body renewal action
| Field | Type | Presence | Description and constraints |
|---|---|---|---|
$ | JSON | Root | discriminator: {"mapping": {"CANCELLED": "#/components/schemas/CancelledActionUpdateRequestBody", "EVALUATING": "#/components/schemas/EvaluatingActionUpdateRequestBody", "NOT_STARTED": "#/components/schemas/ActiveActionUpdateRequestBody", "PLANNING": "#/components/schemas/PlanningActionUpdateRequestBody", "RENEWED": "#/components/schemas/RenewedActionUpdateRequestBody", "TERMINATED": "#/components/schemas/TerminatedActionUpdateRequestBody"}, "propertyName": "type"} |
$ (oneOf 1) | Model | Alternative | Expand Update a vendor agreement — request body — body renewal action type NOT STARTED |
$ (oneOf 2) | Model | Alternative | Expand Update a vendor agreement — request body — body renewal action type CANCELLED |
$ (oneOf 3) | Model | Alternative | Expand Update a vendor agreement — request body — body renewal action type EVALUATING |
$ (oneOf 4) | Model | Alternative | Expand Update a vendor agreement — request body — body renewal action type PLANNING |
$ (oneOf 5) | Model | Alternative | Expand Update a vendor agreement — request body — body renewal action type RENEWED |
$ (oneOf 6) | Model | Alternative | Expand Update a vendor agreement — request body — body renewal action type TERMINATED |
Referenced models: Update a vendor agreement — request body — body renewal action type NOT STARTED, Update a vendor agreement — request body — body renewal action type CANCELLED, Update a vendor agreement — request body — body renewal action type EVALUATING, Update a vendor agreement — request body — body renewal action type PLANNING, Update a vendor agreement — request body — body renewal action type RENEWED, Update a vendor agreement — request body — body renewal action type TERMINATED
Policy, approvals and errors
Section titled “Policy, approvals and errors”SDK function policy ID: ramp.patch_vendor_agreement_resource. Catalog operation: patch_vendor_agreement_resource. Rules can name either ID; function rules distinguish managed calls and conservatively cover raw calls sharing the route. Existing grant permissions and policy rules apply. wait() returns an immediate result or waits for a required approval; it never approves the request itself. Persist the approval ID to resume after a restart.
Provider errors retain their response; JSON decoding raises ProviderAPIError for provider failures. ManagedOperationError identifies contract/input/retention errors. See error handling and provider-specific behavior. Sensitive input may be refused before approval storage. A decoding error never resubmits a write.
Required provider scopes: ["vendors:write"]