/api/models/{slug}/waterfallGet 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
slugstringrequiredModel slug.
Query parameters
org_idstringActing organization. Implied by a key; a session caller must name one.
Responses
200The default chain and your override.
Response
model_idstringslugstringorg_idstring | nulldefaultarray<object>default
idstringpositioninteger0 is tried first.
model_provider_idstring | nullprovider_connection_idstring | nulltarget_kindenumreferenced_model_idstring | nullreferenced_modelobject | nullOne of
object
idstringslugstringdisplay_namestringstatusstring
providerstring | nullprovider_model_idstring | nullbase_urlstring | nullstatusstringrungstring | nullThe token to send in a PUT or PATCH: the deployment id,
byok:{connection_id}ormodel:{model_id}.fundingenumhealthobject | nullOne of
object
statestringFleet verdict, for example healthy, degraded, recovering, throttled, circuit_open, disabled. A BYOK rung reports its connection status.
reasonstring | nulllifecycleenum
overridearray | nullYour organization's chain; null when you have none.
override
idstringpositioninteger0 is tried first.
model_provider_idstring | nullprovider_connection_idstring | nulltarget_kindenumreferenced_model_idstring | nullreferenced_modelobject | nullOne of
object
idstringslugstringdisplay_namestringstatusstring
providerstring | nullprovider_model_idstring | nullbase_urlstring | nullstatusstringrungstring | nullThe token to send in a PUT or PATCH: the deployment id,
byok:{connection_id}ormodel:{model_id}.fundingenumhealthobject | nullOne of
object
statestringFleet verdict, for example healthy, degraded, recovering, throttled, circuit_open, disabled. A BYOK rung reports its connection status.
reasonstring | nulllifecycleenum
default_revisionintegeroverride_revisionintegerSend this back as
expected_revisionon a write.default_stateenumoverride_stateenummodel_references_enabledbooleanWhether
model:{model_id}fallback-model rungs are accepted.semantics_activebooleanfailover_modeenumthrottle_cache_thresholdnumber | nullserved_defaultarray | nullThe 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
idstringpositioninteger0 is tried first.
model_provider_idstring | nullprovider_connection_idstring | nulltarget_kindenumreferenced_model_idstring | nullreferenced_modelobject | nullOne of
object
idstringslugstringdisplay_namestringstatusstring
providerstring | nullprovider_model_idstring | nullbase_urlstring | nullstatusstringrungstring | nullThe token to send in a PUT or PATCH: the deployment id,
byok:{connection_id}ormodel:{model_id}.fundingenumhealthobject | nullOne of
object
statestringFleet verdict, for example healthy, degraded, recovering, throttled, circuit_open, disabled. A BYOK rung reports its connection status.
reasonstring | nulllifecycleenum
401Missing, unknown or revoked API key.
Response
errorstringrequiredHuman-readable message.
codestringStable machine reason, when the route defines one (for example
pro_required).actionstringStable remediation action, when the route defines one.
detailsobjectCustomer-safe string facts the caller needs to act (for example a suggested identifier).
404The model or the organization is not visible to you.
Response
errorstringrequiredHuman-readable message.
codestringStable machine reason, when the route defines one (for example
pro_required).actionstringStable remediation action, when the route defines one.
detailsobjectCustomer-safe string facts the caller needs to act (for example a suggested identifier).
422A session caller omitted
org_id.Response
errorstringrequiredHuman-readable message.
codestringStable machine reason, when the route defines one (for example
pro_required).actionstringStable remediation action, when the route defines one.
detailsobjectCustomer-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