Warehouses

A Warehouse is an upstream source connection. The read-only warehouse API requires a Pro gateway connected to Kubernetes. It includes Secret reference names and keys, never Secret contents. All routes require a key with read scope.

Create and edit connections through the Warehouse CRD or the dashboard’s apply forms.

List Warehouses

curl -H "Authorization: Bearer $LAYER_API_KEY" \
  "$LAYER_BASE_URL/v2/warehouses"

{
  "warehouses": [
    {
      "name": "prod-snowflake",
      "kind": "snowflake",
      "snowflake": {
        "account": "acme-xy12345",
        "user": "SVC_LAYER",
        "role": "SVC_LAYER_ROLE",
        "warehouse": "EXTRACT_WH",
        "keyPairSecretRef": {
          "name": "snowflake-rsa"
        },
        "pool": {
          "size": 5,
          "timeout": "30s"
        }
      },
      "verifyInterval": "1h",
      "status": {
        "phase": "Verified",
        "verifiedAt": "2026-06-10T00:00:00Z",
        "consumers": {
          "pipelines": 2,
          "apiKeys": 1
        },
        "conditions": []
      }
    }
  ]
}

GET /v2/warehouses/{name} returns one object in the same shape. phase is Pending, Verified, or Failed; failed warehouses include status.failureReason. status.consumers counts pipelines and API keys that still reference the warehouse.