> ## Documentation Index
> Fetch the complete documentation index at: https://docs.unstructured.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Update destination connector

> Update the configuration of an existing destination connector.

You must specify all of the settings for the connector, even for settings that are not changing.

You can change any of the connector's settings except for its `name`and `type`.

## Path parameters

<ParamField path="destination_id" type="string" required>
  The unique identifier of the destination connector.
</ParamField>

## Body

<ParamField body="name" type="string">
  New destination connector name.
</ParamField>

<ParamField body="config" type="object">
  Updated connector configuration. Fields vary by connector type.

  For the specific settings to include for a specific connector, see the entry for that connector in [Destinations](/api-reference/workflow/destinations/overview).
</ParamField>

## Response

<ResponseField name="id" type="string" required>
  Unique identifier for the destination connector.
</ResponseField>

<ResponseField name="name" type="string" required>
  Destination connector name.
</ResponseField>

<ResponseField name="type" type="string" required>
  Connector type.
</ResponseField>

<ResponseField name="config" type="object" required>
  Connector configuration. Fields vary by connector `type`.
</ResponseField>

<ResponseField name="created_at" type="string" required>
  ISO 8601 timestamp when the connector was created.
</ResponseField>

<ResponseField name="updated_at" type="string">
  ISO 8601 timestamp when the connector was last updated.
</ResponseField>

<RequestExample>
  ```bash cURL theme={null}
  curl --request PUT \
    --url "${UNSTRUCTURED_API_URL}/api/v1/destinations/d1a2b3c4-5d6e-7f8a-9b0c-1d2e3f4a5b6c" \
    --header "unstructured-api-key: ${UNSTRUCTURED_API_KEY}" \
    --header "Content-Type: application/json" \
    --data '{
      "name": "My Updated S3 Destination",
      "config": {
        "remote_url": "s3://my-new-bucket/output/",
        "aws_access_key_id": "AKIAIOSFODNN7EXAMPLE",
        "aws_secret_access_key": "wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY"
      }
    }'
  ```

  ```python Python SDK theme={null}
  import os
  from unstructured_client import UnstructuredClient
  from unstructured_client.models.operations import UpdateDestinationRequest
  from unstructured_client.models.shared import UpdateDestinationConnector

  client = UnstructuredClient(
      api_key_auth=os.getenv("UNSTRUCTURED_API_KEY"),
      server_url=os.getenv("UNSTRUCTURED_API_URL"),
  )

  response = client.destinations.update_destination(
      request=UpdateDestinationRequest(
          destination_id="d1a2b3c4-5d6e-7f8a-9b0c-1d2e3f4a5b6c",
          update_destination_connector=UpdateDestinationConnector(
              name="My Updated S3 Destination",
              config={
                  "remote_url": "s3://my-new-bucket/output/",
                  "aws_access_key_id": "AKIAIOSFODNN7EXAMPLE",
                  "aws_secret_access_key": "wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY",
              },
          )
      )
  )
  print(response)
  ```

  ```python Python SDK (async) theme={null}
  import asyncio
  import os
  from unstructured_client import UnstructuredClient
  from unstructured_client.models.operations import UpdateDestinationRequest
  from unstructured_client.models.shared import UpdateDestinationConnector

  async def update_destination():
      client = UnstructuredClient(
          api_key_auth=os.getenv("UNSTRUCTURED_API_KEY"),
          server_url=os.getenv("UNSTRUCTURED_API_URL"),
      )
      response = await client.destinations.update_destination_async(
          request=UpdateDestinationRequest(
              destination_id="d1a2b3c4-5d6e-7f8a-9b0c-1d2e3f4a5b6c",
              update_destination_connector=UpdateDestinationConnector(
                  name="My Updated S3 Destination",
                  config={
                      "remote_url": "s3://my-new-bucket/output/",
                      "aws_access_key_id": "AKIAIOSFODNN7EXAMPLE",
                      "aws_secret_access_key": "wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY",
                  },
              )
          )
      )
      print(response)

  asyncio.run(update_destination())
  ```
</RequestExample>

<ResponseExample>
  ```json Response theme={null}
  {
    "id": "d1a2b3c4-5d6e-7f8a-9b0c-1d2e3f4a5b6c",
    "name": "My Updated S3 Destination",
    "type": "s3",
    "config": {
      "remote_url": "s3://my-new-bucket/output/",
      "aws_access_key_id": "AKIAIOSFODNN7EXAMPLE",
      "aws_secret_access_key": "wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY"
    },
    "created_at": "2026-01-01T00:00:00Z",
    "updated_at": "2026-04-29T10:00:00Z"
  }
  ```
</ResponseExample>