Skip to content

List SQL warehouses

GET
/api/v1/warehouses/
curl --request GET \
--url https://example.com/api/v1/warehouses/

List all SQL warehouses in the workspace.

X-Environment-Id
Any of:
string

Successful Response

Media typeapplication/json
WarehouseListResponse

Response model for listing warehouses.

object
warehouses
required
Warehouses

List of warehouses

Array<object>
WarehouseStatusResponse

Response model for warehouse status - backwards compatible.

object
id
required
Id

Warehouse ID

string
name
Any of:
string
state
required
State

Current warehouse state (RUNNING, STOPPED, etc.)

string
cluster_size
Any of:
string
min_num_clusters
Any of:
integer
max_num_clusters
Any of:
integer
auto_stop_mins
Any of:
integer
creator_name
Any of:
string
jdbc_url
Any of:
string
odbc_params
Any of:
object
key
additional properties
any
num_clusters
Any of:
integer
num_active_sessions
Any of:
integer
tags
Any of:
object
key
additional properties
string
count
required
Count

Total number of warehouses

integer
Examplegenerated
{
"warehouses": [
{
"id": "example",
"name": "example",
"state": "example",
"cluster_size": "example",
"min_num_clusters": 1,
"max_num_clusters": 1,
"auto_stop_mins": 1,
"creator_name": "example",
"jdbc_url": "example",
"odbc_params": {},
"num_clusters": 1,
"num_active_sessions": 1,
"tags": {
"additionalProperty": "example"
}
}
],
"count": 1
}

Validation Error

Media typeapplication/json
HTTPValidationError
object
detail
Detail
Array<object>
ValidationError
object
loc
required
Location
Array
msg
required
Message
string
type
required
Error Type
string
Examplegenerated
{
"detail": [
{
"loc": [
"example"
],
"msg": "example",
"type": "example"
}
]
}