DELETE/api/models/{slug}/waterfall

Reset your waterfall to the default

Removes your organization's override so the model serves you the default chain again, under the same compare-and-swap as every chain write (a stale expected_revision answers 409). Any key of the organization may reset; a session needs the org admin role.

認証: AuthorizationヘッダーにBearer形式のAPIキー

パスパラメータ

  • slugstring必須

    Model slug.

クエリパラメータ

  • expected_revisioninteger必須

    The override_revision from your last read.

  • org_idstring

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

レスポンス

  • 200

    The waterfall after the reset (override null).

    レスポンス
    • 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
        いずれか

        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
        いずれか

        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
        いずれか

        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
        いずれか

        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
        いずれか

        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
        いずれか

        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.

    レスポンス
    • errorstring必須

      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).

  • 403

    A session member below the org admin role.

    レスポンス
    • errorstring必須

      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 resource does not exist or belongs to another organization.

    レスポンス
    • errorstring必須

      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).

  • 409

    expected_revision is stale.

    レスポンス
    • errorstring必須

      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

    The body or query failed validation.

    レスポンス
    • detailarray<object>必須
      detail
      • typestring
      • locarray<string | integer>
      • msgstring

リクエスト

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

レスポンス

{
  "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": 3,
  "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?expected_revision=2&org_id=3f6c2a1e-8b7d-4c2a-9e51-6a0d4b2f7c10