Update Shipping Method
Update Shipping Method — vendor REST API endpoint.
/vendor/me/shipping-methods/:idVendor bearer token requiredUpdate Shipping Method
Update an existing shipping method.
Partially update a shipping method by ID. Requires OWNER, ADMIN, or EDITOR role. When sending `countryRates`, it replaces the full rate list.
When to use this
- Updating shipping rates or deactivating a method.
Path parameters
| Name | Type | Required | Description |
|---|---|---|---|
| id | string (UUID) | Yes | Shipping method ID. |
Request body
| Name | Type | Required | Description |
|---|---|---|---|
| name | string | No | Updated name. |
| isActive | boolean | No | Enable or disable. |
| pricingType | string | No | `FLAT_RATE` or `WEIGHT_BASED`. |
| currency | string | No | ISO currency code (max 3). |
| description | string | No | Optional description. |
| countryRates[].countryCode | string | No | ISO country code. Sending `countryRates` replaces the entire rate list. |
| countryRates[].flatRate | number | No | Updated flat rate for this country. |
Request example
curl -X PATCH 'https://api.next.gcommerce.glass/api/v1/vendor/me/shipping-methods/550e8400-e29b-41d4-a716-446655440060' \
-H 'Content-Type: application/json'Response examples
{
"id": "550e8400-e29b-41d4-a716-446655440060",
"name": "Standard Shipping",
"isActive": true,
"pricingType": "FLAT_RATE",
"weightLimitMin": null,
"weightLimitMax": null,
"currency": "USD",
"description": "5-7 business days",
"countryRates": [
{
"id": "550e8400-e29b-41d4-a716-446655440061",
"methodId": "550e8400-e29b-41d4-a716-446655440060",
"countryCode": "US",
"flatRate": "9.99",
"baseRate": null,
"weightTiers": []
}
],
"createdAt": "2025-03-01T10:00:00.000Z",
"updatedAt": "2025-03-01T10:00:00.000Z"
}Status codes
OK
Request succeeded.
Unauthorized
Missing or invalid bearer token.
Forbidden
Insufficient permissions for this action.
Bad Request
Validation failed or invalid parameters.
Not Found
Resource not found.
Too Many Requests
Global rate limit exceeded (10,000 requests per 10 minutes per IP).
Internal Server Error
Unexpected server error.
Forbidden
No vendor membership, or insufficient vendor role (requires OWNER, ADMIN, or EDITOR for write operations).
Try it
Uses your saved session from login. Edit values and send a live request, or copy the cURL command.