Update RateGroup

This operation updates the details of an existing RateGroup identified by its RateGroup ID. You can modify attributes such as the display name, status (active/inactive), audience type (Enterprise, Location, or Users and Roles), and the list of carriers and services associated with the RateGroup. Once updated, the revised RateGroup will be available for use in dynamic rate shopping through the Rate and Create Shipment APIs. Read How to create RateGroup

SecuritybearerAuth
Request
path Parameters
rateGroupId
required
string

Unique identifier of the RateGroup created. This Id is used in rate shipment and create shipment requests for automatic rate shopping.

Example: Q6Wp3onr3JNlDXx
Request Body schema: application/json
name
required
string

Display name of the RateGroup. This will be used as the RateGroup's nickname or label.

countryCode
required
string

Two-letter ISO country code representing the shipment origin for which the RateGroup is created.

status
string

Defines whether the RateGroup is available for use (active) or not (inactive).

Enum: "active" "in-active"
permissionEntityBy
string

Defines the audience who can access and use this RateGroup.

  • E: Enterprise (all users in the organization). If permissionEntityBy is not explicitly provided, Enterprise is set as the default entity.
  • L: Locations (restricted to specific locations)
  • R: User Roles (restricted to specific roles, e.g., Admin or USER)
  • U: Users
Enum: "E" "L" "R" "U"
Array of objects

List of audience identifiers who can access the RateGroup as set in permissionEntityBy.

required
Array of objects

Array of carriers and their services to be included in the RateGroup for rate shopping.

Responses
200

Rategroup metadata has been updated successfully.

400

Invalid request.

401

The request could not be authorized.

500

The request could not be completed due to an internal error.

put/api/v1/rategroups/{rateGroupId}
Request samples
application/json
{
  • "name": "RATEGROUP USERS2",
  • "countryCode": "US",
  • "status": "active",
  • "permissionEntityBy": "R",
  • "permissions": [
    ],
  • "items": [
    ]
}
Response samples
application/json
{
  • "rateGroupId": "wZJvKEBg0gPVbZ5"
}