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

# Update import storage

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

Update a specific S3 import storage connection.

## Path parameters

- `id` integer, required

## Request body

- object
  - `aws_access_key_id` string — AWS_ACCESS_KEY_ID
  - `aws_secret_access_key` string — AWS_SECRET_ACCESS_KEY
  - `aws_session_token` string — AWS_SESSION_TOKEN
  - `aws_sse_kms_key_id` string — AWS SSE KMS Key ID
  - `bucket` string — S3 bucket name
  - `description` string — Storage description
  - `prefix` string — S3 bucket prefix
  - `presign` boolean — Presign URLs for download
  - `presign_ttl` integer — Presign TTL in minutes
  - `project` integer — Project ID
  - `recursive_scan` boolean — Scan recursively
  - `regex_filter` string — Cloud storage regex for filtering objects. You must specify it otherwise no objects will be imported.
  - `region_name` string — AWS Region
  - `s3_endpoint` string — S3 Endpoint
  - `title` string — Storage title
  - `use_blob_urls` boolean — Interpret objects as BLOBs and generate URLs. For example, if your bucket contains images, you can use this option to generate URLs for these images. If set to False, it will read the content of the file and load it into Label Studio.

## Response `200`

- S3ImportStorage
  - `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
  - `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
  - `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
  - `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.dev/humansignal/apis/label-studio-api.md) · [All operations](https://skmtc.dev/humansignal/apis/label-studio-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/humansignal/label-studio-api/revisions/d61bc77f80bc/schema)