Buckets

List bucket listings

Lists all bucket exposures (BigQuery Analytics Hub listings) in the project or development branch. Returns an empty array when no listings exist. The endpoint is BigQuery-only; Snowflake Partner Connect projects receive a 501 response. Each row mirrors the per-bucket GET /v2/storage/buckets/{bucketId}/listing response and additionally carries the source bucketId so the listing can be cross-referenced without a second call. Data is read from the database - no backend API call is performed.

get/v2/storage/listings

Request

Base URL
https://connection.keboola.com
Auth
- API key in header X-StorageApi-Token
- or API key in header X-KBC-ManageApiToken
- or HTTP bearer
TypeScript
https://skmtc.dev/keboola/apis/keboola-storage-api/docs/v2/storage/listings/get.ts
A function with typed inputs. Its response is checked against the schema.

Response

List of bucket listings the token has manage privilege on.

bucketIdstring required

Identifier of the bucket the listing is attached to.

namestring required

Human-readable listing name (used as the backend listing displayName).

descriptionstring

Listing description. Present only when one is set.

backend'bigquery' | 'snowflake' required

Backend of the listed bucket.

createdAtstring date-time required

Listing creation timestamp.

Changes

No recorded changes to this operation across all 1 revision of this API.

List bucket listings

Request

Response 200OK

Changes

Response