**Version: 202601**

# Update carrier service

**PUT** `/openapi/2026-01/carrier_services/:carrier_service_id`

Allows users to update the details of an existing carrier service.

## Request

**Path Parameters**

- `carrier_service_id` string (required)

  Carrier service ID to update

**application/json**

**Body | Example**

**Body (required)**

- `carrier_service` object (required)

  Carrier service data to update

  - `callback_url` string (required)

    Updated callback URL for shipping rate calculation
  - `active` boolean (required)

    Whether to enable the carrier service

```json
{
  "carrier_service": {
    "callback_url": "string",
    "active": true
  }
}
```

## Responses

**200**

OK

**application/json**

**Schema | Example**

**Schema**

- `code` string

  error code
- `message` string

  error message
- `data` object

  - `carrier_service` object

    The updated carrier service

    - `id` string

      Carrier service ID
    - `name` string

      Name of the carrier service
    - `active` boolean

      Whether the carrier service is active
    - `callback_url` string

      Callback URL for rate calculation
    - `scopes` string

      Permission scopes (comma-separated)
    - `carrier_service_code` string

      Carrier service code
    - `logo` string

      Logo URL
    - `short_desc` string

      Brief description of the carrier service
    - `created_at` string

      Creation time, in ISO-8601 format
    - `updated_at` string

      Last update time, in ISO-8601 format

```json
{
  "code": "string",
  "message": "string",
  "data": {
    "carrier_service": {
      "id": "string",
      "name": "string",
      "active": true,
      "callback_url": "string",
      "scopes": "string",
      "carrier_service_code": "string",
      "logo": "string",
      "short_desc": "string",
      "created_at": "string",
      "updated_at": "string"
    }
  }
}
```