Skip to main content
PUT
/
api
/
v1
/
destinations
/
{destination_id}
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"
    }
  }'

{
  "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"
}

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.

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 nameand type.

​
Path parameters

​
destination_id
string
required
The unique identifier of the destination connector.

​
Body

​
name
string
New destination connector name.
​
config
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.

​
Response

​
id
string
required
Unique identifier for the destination connector.
​
name
string
required
Destination connector name.
​
type
string
required
Connector type.
​
config
object
required
Connector configuration. Fields vary by connector type.
​
created_at
string
required
ISO 8601 timestamp when the connector was created.
​
updated_at
string
ISO 8601 timestamp when the connector was last updated.
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"
    }
  }'

{
  "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"
}