# Replace delivery tags

`PUT https://api.cademi.com.br/api/v3/sales/deliveries/{delivery_id}/tags`

Operation ID: `deliveries.tags.update` · API v3

Replaces the set of tags automatically applied by the delivery.

The new set applies only to subsequent sales. Tags are not added to or removed from users who have already purchased; to apply the current tags to them, use the tag application operation.

Required permissions: `deliveries.update`.

## Parameters

| Name | In | Type | Required | Description |
|---|---|---|---|---|
| `delivery_id` | path | string | yes |  |

## Request body

Content type: `application/json`, required.

| Field | Type | Required | Description |
|---|---|---|---|
| `tag_ids` | array of string | yes |  |

## Responses

### 200

Returns the delivery's tags.

Body: `data`: DeliveryTags.

Fields of DeliveryTags:

| Field | Type | Required | Description |
|---|---|---|---|
| `object` | string, one of `delivery_tags` | yes |  |
| `tag_ids` | array of string | yes |  |

### 401

The credential is missing, malformed, expired, or revoked.

Body: Error.

### 403

The current credentials do not have the permission required by this operation.

Body: Error.

### 404

The delivery was not found or is not accessible with the current credentials.

Body: Error.

### 422

The request body or query parameters failed validation.

Body: ValidationFailed.

Full schema: https://cademi.dev/openapi/v3.json