---
title: "(BETA) List registered AI Lake ObjectStorages"
method: GET
path: "/api/v1/ailake/objectStorages"
tags: ["AI Lake - Databases"]
---

# (BETA) List registered AI Lake ObjectStorages

`GET /api/v1/ailake/objectStorages`

## Request

- Base URL: `https://www.gooddata.ai`
- URL: `https://www.gooddata.ai/api/v1/ailake/objectStorages`
- Auth: none declared

(BETA) Lists ObjectStorages registered for the organization. Pass the returned `storageId` to the ProvisionDatabase `storageIds` list. Provider credentials are stripped — only safe descriptors (id, name, type, bucket, region, endpoint, …) are returned.

## Query parameters

- `page` integer: Zero-based page number.
- `size` integer: Number of items per page.
- `metaInclude` string[]

## Response `200`

AI Lake ObjectStorages successfully retrieved

- JsonApiListDocumentObjectStorageInfo: JSON:API-compatible list response envelope
  - `data` JsonApiItemObjectStorageInfo[], required: Array of resource items
    - `attributes` ObjectStorageInfo, required: Descriptor of a registered ObjectStorage. Provider credentials are stripped — only fields useful for identifying the storage are returned.
      - `name` string, required: Human-readable name. Pass `storageId` to ProvisionDatabase.storageIds.
      - `storageConfig` object, required: Provider-specific descriptors (e.g. bucket, region, endpoint, container). Credential references (any keys ending in `_env`) are stripped server-side.
      - `storageId` string, required: Stable identifier of the storage configuration (UUID).
      - `storageType` string, required: Provider type.
    - `id` string, required: Resource identifier
    - `type` string, required: Resource type
  - `links` JsonApiListLinks, required: Links object for a list response
    - `self` string, required: The URL of this response
  - `meta` JsonApiListMeta: Metadata for a paginated list response
    - `page` JsonApiPageInfo, required: Pagination information
      - `number` integer, required: Zero-based page number
      - `size` integer, required: Page size
      - `totalElements` integer: Total number of elements; only present when metaInclude=page was requested
      - `totalPages` integer: Total number of pages; only present when metaInclude=page was requested

---

[API](https://skmtc.dev/gooddata/apis/gooddata-cn-oapi-all-api.md) - [All operations](https://skmtc.dev/gooddata/apis/gooddata-cn-oapi-all-api/llms.txt) - [OpenAPI document](https://skmtc.dev/gooddata/apis/gooddata-cn-oapi-all-api/revisions/c728ef303bfb?raw)