---
title: "✨ Update import storage"
method: PATCH
path: "/api/storages/s3s/{id}"
tags: ["Storage: S3 Roles"]
---

# ✨ Update import storage

`PATCH /api/storages/s3s/{id}`

<Card href="https://humansignal.com/goenterprise">
        <img style="pointer-events: none; margin-left: 0px; margin-right: 0px;" src="https://docs.humansignal.com/images/badge.svg" alt="Label Studio Enterprise badge"/>
        <p style="margin-top: 10px; font-size: 14px;">
            This endpoint is not available in Label Studio Community Edition. [Learn more about Label Studio Enterprise](https://humansignal.com/goenterprise)
        </p>
    </Card>
Update a specific S3 import storage connection that was set up with IAM role access.

## Path parameters

- `id` integer, required

## Request body

- PatchedLseS3ImportStorageRequest
  - `aws_access_key_id` string, nullable — AWS_ACCESS_KEY_ID
  - `aws_secret_access_key` string, nullable — AWS_SECRET_ACCESS_KEY
  - `aws_session_token` string, nullable — AWS_SESSION_TOKEN
  - `aws_sse_kms_key_id` string, nullable — AWS SSE KMS Key ID
  - `bucket` string, nullable — S3 bucket name
  - `description` string, nullable — Cloud storage description
  - `external_id` string, nullable — AWS ExternalId
  - `last_sync` string, date-time, nullable — Last sync finished time
  - `last_sync_count` integer, nullable — Count of tasks synced last time
  - `last_sync_job` string, nullable — Last sync job ID
  - `legacy_auth` boolean, nullable
  - `meta` unknown
  - `prefix` string, nullable — S3 bucket prefix
  - `presign` boolean
  - `presign_ttl` integer — Presigned URLs TTL (in minutes)
  - `project` integer — A unique integer value identifying this project.
  - `recursive_scan` boolean — Perform recursive scan over the bucket content
  - `regex_filter` string, nullable — Cloud storage regex for filtering objects
  - `region_name` string, nullable — AWS Region
  - `role_arn` string — AWS RoleArn
  - `s3_endpoint` string, nullable — S3 Endpoint
  - `status` 'initialized' | 'queued' | 'in_progress' | 'failed' | 'completed' | 'completed_with_errors' — * `initialized` - Initialized * `queued` - Queued * `in_progress` - In progress * `failed` - Failed * `completed` - Completed * `completed_with_errors` - Completed with errors
  - `synchronizable` boolean
  - `title` string, nullable — Cloud storage title
  - `traceback` string, nullable — Traceback report for the last failed sync
  - `use_blob_urls` boolean — Interpret objects as BLOBs and generate URLs

## Response `200`

- LseS3ImportStorage
  - `aws_access_key_id` string, nullable — AWS_ACCESS_KEY_ID
  - `aws_secret_access_key` string, nullable — AWS_SECRET_ACCESS_KEY
  - `aws_session_token` string, nullable — AWS_SESSION_TOKEN
  - `aws_sse_kms_key_id` string, nullable — AWS SSE KMS Key ID
  - `bucket` string, nullable — S3 bucket name
  - `created_at` string, date-time, required — Creation time
  - `description` string, nullable — Cloud storage description
  - `external_id` string, nullable — AWS ExternalId
  - `id` integer, required
  - `last_sync` string, date-time, nullable — Last sync finished time
  - `last_sync_count` integer, nullable — Count of tasks synced last time
  - `last_sync_job` string, nullable — Last sync job ID
  - `legacy_auth` boolean, nullable
  - `meta` unknown
  - `prefix` string, nullable — S3 bucket prefix
  - `presign` boolean
  - `presign_ttl` integer — Presigned URLs TTL (in minutes)
  - `project` integer, required — A unique integer value identifying this project.
  - `recursive_scan` boolean — Perform recursive scan over the bucket content
  - `regex_filter` string, nullable — Cloud storage regex for filtering objects
  - `region_name` string, nullable — AWS Region
  - `role_arn` string, required — AWS RoleArn
  - `s3_endpoint` string, nullable — S3 Endpoint
  - `status` 'initialized' | 'queued' | 'in_progress' | 'failed' | 'completed' | 'completed_with_errors' — * `initialized` - Initialized * `queued` - Queued * `in_progress` - In progress * `failed` - Failed * `completed` - Completed * `completed_with_errors` - Completed with errors
  - `synchronizable` boolean
  - `title` string, nullable — Cloud storage title
  - `traceback` string, nullable — Traceback report for the last failed sync
  - `type` string, required
  - `use_blob_urls` boolean — Interpret objects as BLOBs and generate URLs

---

[API](https://skmtc.net/humansignal/apis/label-studio-api.md) · [All operations](https://skmtc.net/humansignal/apis/label-studio-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/humansignal/label-studio-api/versions/1b113b8df950/schema)