Storages

Cloud storage configuration

Get Storages

get

https://imeritapi.ango.ai/v2https://testapi.ango.ai/v2

/storages

Retrieves all storage configurations for your organization

Authorizations

ApiKeyAuth

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

curlJavaScriptPython

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": "2026-02-08T06:27:29.735Z"
      }
    ]
  }
}

Create Storage

post

https://imeritapi.ango.ai/v2https://testapi.ango.ai/v2

/storages

Creates a new cloud storage configuration

Authorizations

ApiKeyAuth

apikeystringRequired

API key for authentication. Format - apikey YOUR_API_KEY

Body

application/json

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

curlJavaScriptPython

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": "2026-02-08T06:27:29.735Z"
    }
  }
}

Delete Storage

delete

https://imeritapi.ango.ai/v2https://testapi.ango.ai/v2

/storages/{storageId}

Deletes a storage configuration

Authorizations

ApiKeyAuth

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}

HTTPcURLJavaScriptPython

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": "2026-02-08T06:27:29.735Z"
    }
  }
}

List Storage Files

get

https://imeritapi.ango.ai/v2https://testapi.ango.ai/v2

/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

ApiKeyAuth

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

curlJavaScriptPython

# List files in root directory with signed URLs
curl -X GET "https://imeritapi.ango.ai/v2/storages/YOUR_STORAGE_ID/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/YOUR_STORAGE_ID/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=..."
      }
    ]
  }
}