extensions / Commerce extension
PATCH
/api/projects/{project_id}/sales/shipment-restrictions/{restriction_id}Update Shipment Restriction
Updates an existing shipment restriction for a project from the supplied configuration and returns the updated record.
Authentication
- Requirement
- Required
- Credential type
- Bearer API key
- Scopes
- Not specified
Permissions
- Requests are scoped to the target project_id. API-key requests must use a key with an active connection to that project.
Headers
| Name | Required | Type | Details |
|---|---|---|---|
Authorization | Yes | Not specified | Description: Bearer credential used to authenticate the request. |
Path Parameters
| Name | Required | Type | Details |
|---|---|---|---|
project_id | Yes | Not specified | Description: Target project identifier. |
restriction_id | Yes | Not specified | Description: Identifier for restriction. |
Query Parameters
Request Body
Schema: UpsertShipmentRestrictionRequest
| Field | Required | Type | Details |
|---|---|---|---|
name | No | string | Description: Display name. |
description | No | string | Description: Long-form description text. |
is_active | No | boolean | Description: Boolean flag. |
restricted_carriers | No | JSON | Description: JSON object. |
restricted_methods | No | JSON | Description: JSON object. |
show_message | No | boolean | Description: Boolean flag. |
restriction_message | No | string | Description: Text value. |
show_message_once | No | boolean | Description: Boolean flag. |
conditions | No | JSON | Description: JSON object. |
admin_area_only | No | boolean | Description: Boolean flag. |
customer_roles | No | JSON | Description: JSON object. |
days_of_week | No | JSON | Description: JSON object. |
time_from | No | chrono::NaiveTime | Description: Value used by this operation. |
time_to | No | chrono::NaiveTime | Description: Value used by this operation. |
apply_with_coupon_codes | No | JSON | Description: JSON object. |
apply_with_cart_rules | No | JSON | Description: JSON object. |
do_not_apply_with_coupon_codes | No | JSON | Description: JSON object. |
do_not_apply_with_cart_rules | No | JSON | Description: JSON object. |
Response Body
Example 200 response
json
{
"id": 1,
"project_id": 1,
"name": "Example",
"description": "string",
"is_active": "string",
"restricted_carriers": [],
"restricted_methods": [],
"show_message": "string",
"restriction_message": "string",
"show_message_once": "string",
"conditions": [],
"admin_area_only": "string",
"customer_roles": [],
"days_of_week": "string",
"time_from": "string",
"time_to": "string",
"apply_with_coupon_codes": [],
"apply_with_cart_rules": [],
"do_not_apply_with_coupon_codes": [],
"do_not_apply_with_cart_rules": [],
"created_at": "2026-01-01T00:00:00Z",
"updated_at": "2026-01-01T00:00:00Z"
}Errors
404 not_foundAvailability
- Available in
- v0.1.0
- Available since
- v0.1.0
- Implementation
- Available
- Deprecation
- Not specified
- Rate limits
- Not specified