✨ Update import storage | API Reference

curl -X PATCH http://localhost:8000/api/storages/s3s/1 \
     -H "Authorization: Token  <api_key>" \
     -H "Content-Type: application/json" \
     -d '{}'

{
  "created_at": "2024-01-15T09:30:00Z",
  "id": 1,
  "project": 101,
  "role_arn": "arn:aws:iam::123456789012:role/LabelStudioS3AccessRole",
  "type": "s3s",
  "aws_access_key_id": "AKIAIOSFODNN7EXAMPLE",
  "aws_secret_access_key": "wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY",
  "aws_session_token": "FQoGZXIvYXdzEJr//////////wEaDK1EXAMPLESESSIONTOKEN",
  "aws_sse_kms_key_id": "arn:aws:kms:us-west-2:123456789012:key/abcd1234-56ef-78gh-90ij-klmnopqrstuv",
  "bucket": "label-studio-data-bucket",
  "description": "S3 storage for project data imports",
  "external_id": "1234567890",
  "last_sync": "2024-01-15T09:30:00Z",
  "last_sync_count": 42,
  "last_sync_job": "sync-job-20240115-0930",
  "legacy_auth": false,
  "meta": null,
  "prefix": "datasets/2024/",
  "presign": true,
  "presign_ttl": 60,
  "recursive_scan": true,
  "regex_filter": "^.*\\.(jpg|png|json)$",
  "region_name": "us-west-2",
  "s3_endpoint": "https://s3.us-west-2.amazonaws.com",
  "status": "initialized",
  "synchronizable": true,
  "title": "Project 101 S3 Storage",
  "traceback": "",
  "use_blob_urls": false
}

This endpoint is not available in Label Studio Community Edition. Learn more about Label Studio Enterprise

Update a specific S3 import storage connection that was set up with IAM role access.

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

Authentication

AuthorizationToken

The token (or API key) must be passed as a request header. You can find your user token on the User Account page in Label Studio. Example: <br><pre><code class="language-bash">curl https://label-studio-host/api/projects -H "Authorization: Token [your-token]"</code></pre>

Path parameters

idintegerRequired

Request

This endpoint expects an object.

aws_access_key_idstring or nullOptional

AWS_ACCESS_KEY_ID

aws_secret_access_keystring or nullOptional

AWS_SECRET_ACCESS_KEY

aws_session_tokenstring or nullOptional

AWS_SESSION_TOKEN

aws_sse_kms_key_idstring or nullOptional

AWS SSE KMS Key ID

bucketstring or nullOptional

S3 bucket name

descriptionstring or nullOptional

Cloud storage description

external_idstring or nullOptional

AWS ExternalId

last_syncdatetime or nullOptional

Last sync finished time

last_sync_countinteger or nullOptional0-2147483647

Count of tasks synced last time

last_sync_jobstring or nullOptional<=256 characters

Last sync job ID

legacy_authboolean or nullOptional

metaany or nullOptional

Meta and debug information about storage processes

prefixstring or nullOptional

S3 bucket prefix

presignbooleanOptionalDefaults to true

presign_ttlintegerOptional0-32767

Presigned URLs TTL (in minutes)

projectintegerOptional

A unique integer value identifying this project.

recursive_scanbooleanOptional

Perform recursive scan over the bucket content

regex_filterstring or nullOptional

Cloud storage regex for filtering objects

region_namestring or nullOptional

AWS Region

role_arnstringOptional>=1 character

AWS RoleArn

s3_endpointstring or nullOptional

S3 Endpoint

statusenumOptional

initialized - Initialized
queued - Queued
in_progress - In progress
failed - Failed
completed - Completed
completed_with_errors - Completed with errors

synchronizablebooleanOptionalDefaults to true

titlestring or nullOptional<=256 characters

Cloud storage title

tracebackstring or nullOptional

Traceback report for the last failed sync

use_blob_urlsbooleanOptional

Interpret objects as BLOBs and generate URLs

Response

created_atdatetimeRead-only

Creation time

idintegerRead-only

projectinteger

A unique integer value identifying this project.

role_arnstring

AWS RoleArn

typestringRead-onlyDefaults to s3s

aws_access_key_idstring or null

AWS_ACCESS_KEY_ID

aws_secret_access_keystring or null

AWS_SECRET_ACCESS_KEY

aws_session_tokenstring or null

AWS_SESSION_TOKEN

aws_sse_kms_key_idstring or null

AWS SSE KMS Key ID

bucketstring or null

S3 bucket name

descriptionstring or null

Cloud storage description

external_idstring or null

AWS ExternalId

last_syncdatetime or null

Last sync finished time

last_sync_countinteger or null0-2147483647

Count of tasks synced last time

last_sync_jobstring or null<=256 characters

Last sync job ID

legacy_authboolean or null

metaany or null

Meta and debug information about storage processes

prefixstring or null

S3 bucket prefix

presignbooleanDefaults to true

presign_ttlinteger0-32767

Presigned URLs TTL (in minutes)

recursive_scanboolean

Perform recursive scan over the bucket content

regex_filterstring or null

Cloud storage regex for filtering objects

region_namestring or null

AWS Region

s3_endpointstring or null

S3 Endpoint

statusenum

initialized - Initialized
queued - Queued
in_progress - In progress
failed - Failed
completed - Completed
completed_with_errors - Completed with errors

synchronizablebooleanDefaults to true

titlestring or null<=256 characters

Cloud storage title

tracebackstring or null

Traceback report for the last failed sync

use_blob_urlsboolean

Interpret objects as BLOBs and generate URLs