Update S3 storage connection

put

https://{hostname}/api/v1/s3_storage_connections/{id}

Updates an S3 storage connection with inline connectivity re-validation.

Path Params

string

required

S3 storage connection ID.

Body Params

access_key_id

string | null

Updated access key ID. If omitted, the stored value is retained.

bucket

string | null

Bucket name. Honored only for Linode bare-regional endpoint updates;
ignored for Linode virtual-hosted updates after the mismatch check,
for Linode updates with no endpoint change, and for all MinIO updates.

config

object

Updated provider-specific configuration. Merged on top of the existing
stored config and the provider defaults; supplied keys override prior
values. JSON null is treated identically to {} (a no-op merge).

display_name

string | null

Updated display name.

endpoint

string | null

Updated endpoint URL.

Linode: bucket and region are re-derived from the new endpoint
(the endpoint host encodes both). For bare-regional endpoints, the
request-body bucket is honored; for virtual-hosted, supplied
bucket must match the host-derived bucket.
MinIO: the endpoint URL does not encode a bucket, so bucket and
region are reused from the existing row regardless of whether
endpoint is supplied. To change a MinIO connection's bucket or
region, create a new connection and delete the old one (SOI §6.3, §7.3).

folder

string | null

Updated folder prefix. Omitted retains the stored value; JSON null
or empty string clears it; otherwise the value is normalized and
validated against the effective bucket per SOI §5.3.

secret_access_key

string | null

Updated secret access key. If omitted, the stored value is retained.

Responses

200S3 storage connection updated.

400Bad request.

401Unauthorized.

403Forbidden.

404Not found.

422Connectivity validation failed.

500Internal server error.

502Storage endpoint unreachable.