/api/models/{slug}/waterfallEdit your waterfall step by step
Applies operations in order to your current chain (your override, else served_default) and writes the result as one chain under compare-and-swap: expected_revision must equal the read's override_revision or the call answers 409 and changes nothing. The shared-model rule of PUT still applies (422). Any key of the organization may edit; a session needs the org admin role.
認証: AuthorizationヘッダーにBearer形式のAPIキー
パスパラメータ
slugstring必須Model slug.
リクエストボディ
org_idstring | nullImplied by a key.
expected_revisioninteger必須The
override_revisionthe edits were planned against.operationsarray<object>必須operations
openum必須rungstring必須A rung token (the
rungfield of a read).positioninteger | null0-based, clamped to the chain end. Omitted on
addappends; required onmove.
レスポンス
200The waterfall after the edit (same shape as GET).
レスポンス
model_idstringslugstringorg_idstring | nulldefaultarray<object>default
idstringpositioninteger0 is tried first.
model_provider_idstring | nullprovider_connection_idstring | nulltarget_kindenumreferenced_model_idstring | nullreferenced_modelobject | nullいずれか
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 | nullいずれか
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 | nullいずれか
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 | nullいずれか
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 | nullいずれか
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 | nullいずれか
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.
レスポンス
errorstring必須Human-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).
403A session member below the org admin role.
レスポンス
errorstring必須Human-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 organization is not visible, or a
move/removenames a rung that is not in the chain.レスポンス
errorstring必須Human-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).
409expected_revisionno longer matchesoverride_revision.レスポンス
errorstring必須Human-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).
422addof a rung already present,movewithout a position, a shared-model chain with nobyok:rung, or a body validation failure.
リクエスト
curl -X PATCH https://api.experientiallabs.ai/api/models/gpt-6-luna/waterfall \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"expected_revision": 1,
"operations": [
{
"op": "move",
"rung": "byok:1e7c3b90-2f4d-4a68-9b15-c0d8e2a7f614",
"position": 0
},
{
"op": "add",
"rung": "3a9d7c1e-5b2f-4e80-9c64-1d8f0a2b7e95"
}
]
}'レスポンス
{
"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": [
{
"id": "2c7e9f14-8a3b-4d56-b1e0-6f4a2d8c9e37",
"position": 0,
"model_provider_id": null,
"provider_connection_id": "1e7c3b90-2f4d-4a68-9b15-c0d8e2a7f614",
"target_kind": "connection",
"referenced_model_id": null,
"referenced_model": null,
"provider": "openai",
"provider_model_id": "gpt-6-luna",
"base_url": null,
"status": "active",
"rung": "byok:1e7c3b90-2f4d-4a68-9b15-c0d8e2a7f614",
"funding": "own_key",
"health": {
"state": "healthy",
"reason": null,
"lifecycle": "active"
}
},
{
"id": "4e1b8d63-7c2a-4f09-a6d5-9b3e0c7f2a18",
"position": 1,
"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"
}
}
],
"default_revision": 4,
"override_revision": 2,
"default_state": "available",
"override_state": "available",
"model_references_enabled": false,
"semantics_active": true,
"failover_mode": "maximize_cache",
"throttle_cache_threshold": 0.5,
"served_default": null
}https://api.experientiallabs.ai/api/models/gpt-6-luna/waterfall