---
title: "List storage destinations"
method: GET
path: "/v1/storage-destinations"
tags: ["Storage Destinations"]
---

# List storage destinations

`GET /v1/storage-destinations`

## Request

- Base URL: `https://hcti.io`
- URL: `https://hcti.io/v1/storage-destinations`
- Auth: HTTP basic

Returns destinations in descending creation order, including disabled destinations. Pass pagination.next_page_start as page_start to continue; null indicates the final page. Secret access keys are never returned.

**Rate limit:** 100 requests per minute per organization, shared across all operations in the `storage-destination:read` group and all API keys belonging to that organization.

## Query parameters

- `count` union
  - integer
  - string, int32
- `page_start` string

## Response `200`

OK

- PaginatedListBaseOfStorageDestinationAndstring
  - `data` StorageDestination[]
    - `id` string, required: Storage destination ID.
    - `name` string, required: Display name for the destination.
    - `enabled` boolean: Whether the destination is enabled.
    - `hcti_storage_disabled` boolean: Whether rendered files saved here are excluded from HCTI storage and the HCTI CDN, with no public HCTI image URL.
    - `provider` string: Display name of the storage provider, retained for compatibility. Use connection_info.provider for the provider's machine-readable identifier.
    - `connection_info` union, required: Provider-specific storage connection details. Secret access keys are never returned.
      - object: Connection details for Amazon S3.
        - `provider` 'aws_s3', required
        - `region` 'af-south-1' | 'ap-east-1' | 'ap-east-2' | 'ap-northeast-1' | 'ap-northeast-2' | 'ap-northeast-3' | 'ap-south-1' | 'ap-south-2' | 'ap-southeast-1' | 'ap-southeast-2' | 'ap-southeast-3' | 'ap-southeast-4' | 'ap-southeast-5' | 'ap-southeast-6' | 'ap-southeast-7' | 'ca-central-1' | 'ca-west-1' | 'eu-central-1' | 'eu-central-2' | 'eu-north-1' | 'eu-south-1' | 'eu-south-2' | 'eu-west-1' | 'eu-west-2' | 'eu-west-3' | 'il-central-1' | 'me-central-1' | 'me-south-1' | 'mx-central-1' | 'sa-east-1' | 'us-east-1' | 'us-east-2' | 'us-west-1' | 'us-west-2', required
        - `role_arn` string, required: ARN of the IAM role HCTI assumes to access the bucket. Configure its trust policy for this organization before saving.
        - `bucket` string, required: Name of the existing bucket or Space. HCTI does not create it.
        - `key_prefix` string, nullable: Optional prefix for object keys within the bucket. Omitted or null uses the bucket root.
      - object: Connection details for Cloudflare R2.
        - `provider` 'cloudflare_r2', required
        - `cloudflare_account_id` string, required: The 32-character hexadecimal Cloudflare account ID that owns the bucket.
        - `cloudflare_jurisdiction` unknown
        - `access_key_id` string, required: S3-compatible access key ID. For Google Cloud Storage, use an HMAC access ID beginning with GOOG.
        - `bucket` string, required: Name of the existing bucket or Space. HCTI does not create it.
        - `key_prefix` string, nullable: Optional prefix for object keys within the bucket. Omitted or null uses the bucket root.
      - object: Connection details for Backblaze B2.
        - `provider` 'backblaze_b2', required
        - `region` 'us-west-000' | 'us-west-001' | 'us-west-002' | 'us-west-004' | 'us-east-005' | 'ca-east-006' | 'eu-central-003', required
        - `access_key_id` string, required: S3-compatible access key ID. For Google Cloud Storage, use an HMAC access ID beginning with GOOG.
        - `bucket` string, required: Name of the existing bucket or Space. HCTI does not create it.
        - `key_prefix` string, nullable: Optional prefix for object keys within the bucket. Omitted or null uses the bucket root.
      - object: Connection details for DigitalOcean Spaces.
        - `provider` 'digitalocean_spaces', required
        - `region` 'nyc3' | 'ams3' | 'sfo2' | 'sfo3' | 'sgp1' | 'lon1' | 'fra1' | 'tor1' | 'blr1' | 'syd1' | 'atl1' | 'ric1' | 'mkc1', required
        - `access_key_id` string, required: S3-compatible access key ID. For Google Cloud Storage, use an HMAC access ID beginning with GOOG.
        - `bucket` string, required: Name of the existing bucket or Space. HCTI does not create it.
        - `key_prefix` string, nullable: Optional prefix for object keys within the bucket. Omitted or null uses the bucket root.
      - object: Connection details for Wasabi.
        - `provider` 'wasabi', required
        - `region` 'us-east-1' | 'us-east-2' | 'us-central-1' | 'us-west-1' | 'us-west-2' | 'ca-central-1' | 'eu-central-1' | 'eu-central-2' | 'eu-west-1' | 'eu-west-2' | 'eu-west-3' | 'eu-south-1' | 'ap-northeast-1' | 'ap-northeast-2' | 'ap-southeast-1' | 'ap-southeast-2', required
        - `access_key_id` string, required: S3-compatible access key ID. For Google Cloud Storage, use an HMAC access ID beginning with GOOG.
        - `bucket` string, required: Name of the existing bucket or Space. HCTI does not create it.
        - `key_prefix` string, nullable: Optional prefix for object keys within the bucket. Omitted or null uses the bucket root.
      - object: Connection details for Google Cloud Storage.
        - `provider` 'google_cloud_storage', required
        - `access_key_id` string, required: S3-compatible access key ID. For Google Cloud Storage, use an HMAC access ID beginning with GOOG.
        - `bucket` string, required: Name of the existing bucket or Space. HCTI does not create it.
        - `key_prefix` string, nullable: Optional prefix for object keys within the bucket. Omitted or null uses the bucket root.
      - object: Connection details for another S3-compatible provider.
        - `provider` 'other_s3_compatible', required
        - `endpoint` string, required: Public HTTPS endpoint of the S3-compatible service. Do not include a path, query string, fragment, or credentials.
        - `region` string, nullable: Signing region expected by the service. Omit or set to null to use us-east-1.
        - `force_path_style` boolean, nullable: Whether to put the bucket name in the URL path instead of the hostname. Omitted or null defaults to true.
        - `access_key_id` string, required: S3-compatible access key ID. For Google Cloud Storage, use an HMAC access ID beginning with GOOG.
        - `bucket` string, required: Name of the existing bucket or Space. HCTI does not create it.
        - `key_prefix` string, nullable: Optional prefix for object keys within the bucket. Omitted or null uses the bucket root.
    - `last_tested_at` string, date-time, nullable: UTC timestamp of the most recent connection test, or null if it has not been tested.
    - `last_test_succeeded` boolean, nullable: Whether the most recent write test succeeded, or null if it has not been tested. This does not verify read access or guarantee future availability.
    - `last_test_error` string, nullable: Sanitized error from the most recent failed connection test, or null when no failure is recorded.
    - `created_at` string, date-time: UTC timestamp when the destination was created.
    - `updated_at` string, date-time: UTC timestamp when the destination was last updated.
  - `pagination` PaginationInfoOfstring
    - `next_page_start` string, nullable, required

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `429`: Too Many Requests

## Changes

- **2026-09-14** `d5730c2a58f6`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/htmlcsstoimage/apis/html-css-to-image-api/changes/v1/storage-destinations/get.md)

---

[API](https://skmtc.dev/htmlcsstoimage/apis/html-css-to-image-api.md) - [All operations](https://skmtc.dev/htmlcsstoimage/apis/html-css-to-image-api/llms.txt) - [OpenAPI document](https://skmtc.dev/htmlcsstoimage/apis/html-css-to-image-api/revisions/100550373ae1?raw)