---
title: "Validate import storage"
method: POST
path: "/api/storages/s3/validate"
tags: ["Storage: S3"]
---

# Validate import storage

`POST /api/storages/s3/validate`

Validate a specific S3 import storage connection.

## Request body

- S3ImportStorageValidateRequest
  - `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
  - `id` integer — Storage ID. If set, storage with specified ID will be updated
  - `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
  - `synchronizable` boolean
  - `title` string, nullable — Cloud storage title
  - `use_blob_urls` boolean — Interpret objects as BLOBs and generate URLs

## Response `200`

Validation successful

## Changes

> 97 revisions in range; 1 not diffed.

- **2026-08-07** `e1ba2ecdbabb` — 3 breaking, 2 warning, 16 info
  - request body became required
  - the request property `project` became required
  - the `title` request property's maxLength was decreased to `256`
  - the `presign_ttl` request property's max was set to `32767.00`
  - …17 more

[Change history](https://skmtc.dev/humansignal/apis/label-studio-api/changes/api/storages/s3/validate/post.md)

---

[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/b589624c66c3/schema)