Storages

Cloud storage configuration

Get Storages

get

/storages

Retrieves all storage configurations for your organization

Authorizations

apikeystringRequired

API key for authentication. Format - apikey YOUR_API_KEY

Query parameters

pageinteger · min: 1Optional

Page number (1-indexed)

Default: 1

limitinteger · min: 1 · max: 100Optional

Items per page (max 100)

Default: 10

Responses

200

Storages retrieved successfully

application/json

get

/storages

curl -X GET "https://imeritapi.ango.ai/v2/storages?page=1&limit=10" \
  -H "apikey: YOUR_API_KEY" \
  -H "Content-Type: application/json"

200

Storages retrieved successfully

{
  "status": "success",
  "data": {
    "storages": [
      {
        "_id": "text",
        "name": "text",
        "type": "aws",
        "bucket": "text",
        "region": "text",
        "organization": "text",
        "createdAt": "2025-12-28T14:13:38.357Z"
      }
    ]
  }
}

Create Storage

post

/storages

Creates a new cloud storage configuration

Authorizations

apikeystringRequired

API key for authentication. Format - apikey YOUR_API_KEY

Body

namestringRequired

typestring · enumRequiredPossible values:

bucketstringRequired

regionstringOptional

credentialsobjectRequired

Storage provider credentials

privateKeystringOptional

Private key (for GCS)

Responses

200

Storage created successfully

application/json

400

Bad request - validation error

application/json

post

/storages

curl -X POST "https://imeritapi.ango.ai/v2/storages" \
  -H "apikey: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "My S3 Storage",
    "type": "aws",
    "bucket": "my-bucket",
    "region": "us-east-1",
    "credentials": {
      "accessKeyId": "YOUR_ACCESS_KEY",
      "secretAccessKey": "YOUR_SECRET_KEY"
    }
  }'

{
  "status": "success",
  "data": {
    "storage": {
      "_id": "text",
      "name": "text",
      "type": "aws",
      "bucket": "text",
      "region": "text",
      "organization": "text",
      "createdAt": "2025-12-28T14:13:38.357Z"
    }
  }
}

Delete Storage

delete

/storages/{storageId}

Deletes a storage configuration

Authorizations

apikeystringRequired

API key for authentication. Format - apikey YOUR_API_KEY

Path parameters

storageIdstringRequired

Storage ID

Responses

200

Storage deleted successfully

application/json

delete

/storages/{storageId}

DELETE /v2/storages/{storageId} HTTP/1.1
Host: imeritapi.ango.ai
apikey: YOUR_API_KEY
Accept: */*

200

Storage deleted successfully

{
  "status": "success",
  "data": {
    "storage": {
      "_id": "text",
      "name": "text",
      "type": "aws",
      "bucket": "text",
      "region": "text",
      "organization": "text",
      "createdAt": "2025-12-28T14:13:38.357Z"
    }
  }
}

List Storage Files

get

/storages/{storageId}/files

Lists files recursively in a cloud storage bucket. This endpoint allows you to browse and retrieve file listings from your configured storage integrations (AWS S3, Google Cloud Storage, Azure Blob Storage, or Custom S3-compatible storage).

Features:

Recursive directory listing
Optional signed URL generation for direct file access
Automatic retry mechanism for S3 rate limit errors
Support for path-based filtering

Use Cases:

Browse storage bucket contents before importing
Generate signed URLs for batch asset uploads
Validate storage configuration and access
List available datasets for annotation projects

Authorizations

apikeystringRequired

API key for authentication. Format - apikey YOUR_API_KEY

Path parameters

storageIdstringRequired

Storage configuration ID

Example: 507f1f77bcf86cd799439011

Query parameters

bucketNamestringRequired

Name of the bucket/container to list files from

Example: my-annotation-data

pathstringOptional

Directory path to list files from. Defaults to root directory if not specified.

Default: ""Example: datasets/images/2024

getSignedUrlsstring · enumOptional

Whether to generate signed URLs for each file. Signed URLs provide temporary authenticated access to private files.

true: Returns signed URLs (24-hour expiry)
false: Returns file metadata only (default)

Default: falseExample: truePossible values:

retryOnSlowDownstring · enumOptional

Enable automatic retry mechanism for S3 SlowDown errors (rate limiting). When enabled, the API will automatically retry with exponential backoff.

true: Retry on rate limit errors (default)
false: Fail immediately on rate limit errors

Default: trueExample: truePossible values:

Responses

200

Files retrieved successfully

application/json

400

Bad Request - Missing required parameters

application/json

401

Unauthorized - invalid or missing API key

application/json

403

Forbidden - insufficient permissions

application/json

404

Storage not found

application/json

get

/storages/{storageId}/files

# List files in root directory with signed URLs
curl -X GET "https://imeritapi.ango.ai/v2/storages/507f1f77bcf86cd799439011/files?bucketName=my-bucket&getSignedUrls=true" \
  -H "apikey: YOUR_API_KEY" \
  -H "Content-Type: application/json"

# List files in specific directory
curl -X GET "https://imeritapi.ango.ai/v2/storages/507f1f77bcf86cd799439011/files?bucketName=my-bucket&path=datasets/images/2024" \
  -H "apikey: YOUR_API_KEY" \
  -H "Content-Type: application/json"

{
  "status": "success",
  "data": {
    "files": [
      {
        "Key": "datasets/images/2024/img001.jpg",
        "Size": 245678,
        "LastModified": "2024-11-18T10:30:00.000Z",
        "ETag": "\"abc123def456\"",
        "SignedUrl": "https://my-bucket.s3.amazonaws.com/datasets/images/2024/img001.jpg?X-Amz-Algorithm=..."
      },
      {
        "Key": "datasets/images/2024/img002.jpg",
        "Size": 198432,
        "LastModified": "2024-11-18T10:31:00.000Z",
        "ETag": "\"def456ghi789\"",
        "SignedUrl": "https://my-bucket.s3.amazonaws.com/datasets/images/2024/img002.jpg?X-Amz-Algorithm=..."
      }
    ]
  }
}

Last updated 4 days ago