GET/api/models/{slug}/waterfall

Get a model's waterfall

Returns the model's default chain, your organization's override (null when none) and served_default (the chain the gateway walks for you without an override, with your substituting BYOK keys in place of the platform rungs they replace). Every rung carries its live health. Pass override_revision back as expected_revision on a write.

Authentication: Bearer API key in the Authorization header

Path parameters

  • slugstringrequired

    Model slug.

Query parameters

  • org_idstring

    Acting organization. Implied by a key; a session caller must name one.

Responses

  • 200

    The default chain and your override.

    Response
    • model_idstring
    • slugstring
    • org_idstring | null
    • defaultarray<object>
      default
      • idstring
      • positioninteger

        0 is tried first.

      • model_provider_idstring | null
      • provider_connection_idstring | null
      • target_kindenum
        "deployment""connection""model"
      • referenced_model_idstring | null
      • referenced_modelobject | null
        One of

        object

        • idstring
        • slugstring
        • display_namestring
        • statusstring
      • providerstring | null
      • provider_model_idstring | null
      • base_urlstring | null
      • statusstring
      • rungstring | null

        The token to send in a PUT or PATCH: the deployment id, byok:{connection_id} or model:{model_id}.

      • fundingenum
        "platform""own_key""own_endpoint""fallback_model"null
      • healthobject | null
        One of

        object

        • statestring

          Fleet verdict, for example healthy, degraded, recovering, throttled, circuit_open, disabled. A BYOK rung reports its connection status.

        • reasonstring | null
        • lifecycleenum
          "active""draining""retired"
    • overridearray | null

      Your organization's chain; null when you have none.

      override
      • idstring
      • positioninteger

        0 is tried first.

      • model_provider_idstring | null
      • provider_connection_idstring | null
      • target_kindenum
        "deployment""connection""model"
      • referenced_model_idstring | null
      • referenced_modelobject | null
        One of

        object

        • idstring
        • slugstring
        • display_namestring
        • statusstring
      • providerstring | null
      • provider_model_idstring | null
      • base_urlstring | null
      • statusstring
      • rungstring | null

        The token to send in a PUT or PATCH: the deployment id, byok:{connection_id} or model:{model_id}.

      • fundingenum
        "platform""own_key""own_endpoint""fallback_model"null
      • healthobject | null
        One of

        object

        • statestring

          Fleet verdict, for example healthy, degraded, recovering, throttled, circuit_open, disabled. A BYOK rung reports its connection status.

        • reasonstring | null
        • lifecycleenum
          "active""draining""retired"
    • default_revisioninteger
    • override_revisioninteger

      Send this back as expected_revision on a write.

    • default_stateenum
      "absent""available""empty""unavailable"
    • override_stateenum
      "absent""available""empty""unavailable"
    • model_references_enabledboolean

      Whether model:{model_id} fallback-model rungs are accepted.

    • semantics_activeboolean
    • failover_modeenum
      "maximize_cache""maximize_availability""maximize_cache_affinity"
    • throttle_cache_thresholdnumber | null
    • served_defaultarray | null

      The chain served to you without an override: the default with your substituting BYOK keys in place of the platform rungs they replace. Null without an acting organization.

      served_default
      • idstring
      • positioninteger

        0 is tried first.

      • model_provider_idstring | null
      • provider_connection_idstring | null
      • target_kindenum
        "deployment""connection""model"
      • referenced_model_idstring | null
      • referenced_modelobject | null
        One of

        object

        • idstring
        • slugstring
        • display_namestring
        • statusstring
      • providerstring | null
      • provider_model_idstring | null
      • base_urlstring | null
      • statusstring
      • rungstring | null

        The token to send in a PUT or PATCH: the deployment id, byok:{connection_id} or model:{model_id}.

      • fundingenum
        "platform""own_key""own_endpoint""fallback_model"null
      • healthobject | null
        One of

        object

        • statestring

          Fleet verdict, for example healthy, degraded, recovering, throttled, circuit_open, disabled. A BYOK rung reports its connection status.

        • reasonstring | null
        • lifecycleenum
          "active""draining""retired"
  • 401

    Missing, unknown or revoked API key.

    Response
    • errorstringrequired

      Human-readable message.

    • codestring

      Stable machine reason, when the route defines one (for example pro_required).

    • actionstring

      Stable remediation action, when the route defines one.

    • detailsobject

      Customer-safe string facts the caller needs to act (for example a suggested identifier).

  • 404

    The model or the organization is not visible to you.

    Response
    • errorstringrequired

      Human-readable message.

    • codestring

      Stable machine reason, when the route defines one (for example pro_required).

    • actionstring

      Stable remediation action, when the route defines one.

    • detailsobject

      Customer-safe string facts the caller needs to act (for example a suggested identifier).

  • 422

    A session caller omitted org_id.

    Response
    • errorstringrequired

      Human-readable message.

    • codestring

      Stable machine reason, when the route defines one (for example pro_required).

    • actionstring

      Stable remediation action, when the route defines one.

    • detailsobject

      Customer-safe string facts the caller needs to act (for example a suggested identifier).

Request

curl https://api.experientiallabs.ai/api/models/gpt-6-luna/waterfall?org_id=3f6c2a1e-8b7d-4c2a-9e51-6a0d4b2f7c10 \
  -H "Authorization: Bearer YOUR_API_KEY"

Response

{
  "model_id": "6adffebe-5ed8-4466-8d2c-976afee63237",
  "slug": "gpt-6-luna",
  "org_id": "3f6c2a1e-8b7d-4c2a-9e51-6a0d4b2f7c10",
  "default": [
    {
      "id": "81297474-de0d-401e-b193-61746f3a0576",
      "position": 0,
      "model_provider_id": "b6574b0e-933c-4b69-993e-2a0d21e32385",
      "provider_connection_id": null,
      "target_kind": "deployment",
      "referenced_model_id": null,
      "referenced_model": null,
      "provider": "openai",
      "provider_model_id": "gpt-6-luna",
      "base_url": null,
      "status": "active",
      "rung": "b6574b0e-933c-4b69-993e-2a0d21e32385",
      "funding": "platform",
      "health": {
        "state": "healthy",
        "reason": null,
        "lifecycle": "active"
      }
    }
  ],
  "override": null,
  "default_revision": 4,
  "override_revision": 0,
  "default_state": "available",
  "override_state": "absent",
  "model_references_enabled": false,
  "semantics_active": true,
  "failover_mode": "maximize_cache",
  "throttle_cache_threshold": 0.5,
  "served_default": [
    {
      "id": "81297474-de0d-401e-b193-61746f3a0576",
      "position": 0,
      "model_provider_id": "b6574b0e-933c-4b69-993e-2a0d21e32385",
      "provider_connection_id": null,
      "target_kind": "deployment",
      "referenced_model_id": null,
      "referenced_model": null,
      "provider": "openai",
      "provider_model_id": "gpt-6-luna",
      "base_url": null,
      "status": "active",
      "rung": "b6574b0e-933c-4b69-993e-2a0d21e32385",
      "funding": "platform",
      "health": {
        "state": "healthy",
        "reason": null,
        "lifecycle": "active"
      }
    }
  ]
}

https://api.experientiallabs.ai/api/models/gpt-6-luna/waterfall?org_id=3f6c2a1e-8b7d-4c2a-9e51-6a0d4b2f7c10