---
title: "Update an S3 data forwarding destination."
method: PUT
path: "/v1/logsDataForwarding/destinations/{id}"
tags: ["logsDataForwardingManagement"]
---

# Update an S3 data forwarding destination.

`PUT /v1/logsDataForwarding/destinations/{id}`

Update an S3 data forwarding destination by the given identifier.

## Path parameters

- `id` string, required

## Request body

- UpdateBucketDefinition
  - `destinationName` string — Name of the S3 data forwarding destination.
  - `description` string — Description of the S3 data forwarding destination.
  - `authenticationMode` string, required — AWS IAM authentication method used for access. Possible values are: 1. `AccessKey` 2. `RoleBased`
  - `accessKeyId` string — The AWS Access ID to access the S3 bucket.
  - `secretAccessKey` string — The AWS Secret Key to access the S3 bucket.
  - `roleArn` string — The AWS Role ARN to access the S3 bucket.
  - `region` string — The region where the S3 bucket is located.
  - `encrypted` boolean — Enable S3 server-side encryption.
  - `enabled` boolean — True if the destination is Active.

## Response `200`

The data forwarding destination has been updated.

- BucketDefinition
  - `destinationName` string, required — Name of the S3 data forwarding destination.
  - `description` string — Description of the S3 data forwarding destination.
  - `authenticationMode` string, required — AWS IAM authentication method used for access. Possible values are: 1. `AccessKey` 2. `RoleBased`
  - `accessKeyId` string — The AWS Access ID to access the S3 bucket.
  - `secretAccessKey` string — The AWS Secret Key to access the S3 bucket.
  - `roleArn` string — The AWS Role ARN to access the S3 bucket.
  - `region` string — The region where the S3 bucket is located.
  - `encrypted` boolean — Enable S3 server-side encryption.
  - `enabled` boolean — True if the destination is Active.
  - `bucketName` string, required — The name of the Amazon S3 bucket.
  - `createdAt` string, date-time, required — Creation timestamp in UTC in [RFC3339](https://tools.ietf.org/html/rfc3339) format.
  - `createdBy` string, required — Identifier of the user who created the resource.
  - `modifiedAt` string, date-time, required — Last modification timestamp in UTC.
  - `modifiedBy` string, required — Identifier of the user who last modified the resource.
  - `id` string, required — The unique identifier of the data forwarding destination.
  - `invalidatedBySystem` boolean — True if invalidated by the system.

## Other responses

- `default` — Operation failed with an error.

---

[API](https://skmtc.net/sumologic/apis/sumo-logic-api.md) · [All operations](https://skmtc.net/sumologic/apis/sumo-logic-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/sumologic/sumo-logic-api/revisions/e4e4c7554890/schema)