PUT/api/orgs/{org_id}/provider/lanes/{lane_id}/listing

List or unlist a model lane

listed: true sets the lane active: it enters the catalog, appears in /v1/models and is callable within about a minute. Your first listed lane also moves the provider from onboarding to canary. listed: false sets the lane disabled without demoting the provider. A lane without base input and output prices and supports_streaming is refused 422. Org admin session or the org's own key.

Authentication: Bearer API key in the Authorization header

Path parameters

  • org_idstringrequired

    Your organization id (uuid). GET /api/whoami returns it.

  • lane_idstringrequired

    The lane id (lanes[].lane_id on the provider home). Must be one of your own public lanes.

Request body

  • listedbooleanrequired

    true lists (serves) the lane; false takes it off the catalog.

Responses

  • 200

    The lane after the change.

    Response
    • lane_idstringrequired
    • model_slugstringrequired
    • model_display_namestringrequired
    • wire_idstringrequired
    • pricesobjectrequired

      Lane rates in integer nano-USD per million tokens; null means unknown, never zero.

      prices
      • input_nano_usd_per_millioninteger | nullrequired
      • cached_input_nano_usd_per_millioninteger | nullrequired
      • output_nano_usd_per_millioninteger | nullrequired
      • reasoning_nano_usd_per_millioninteger | nullrequired
    • data_policyobject | nullrequired
      One of

      object

      • retains_promptsbooleanrequired
      • retention_daysinteger | null

        Days prompts are kept.

      • trains_on_databooleanrequired
      • zero_data_retentionbooleanrequired
      • policy_urlstring | null

        Public https URL of the policy.

    • dispatchobject | nullrequired
      One of

      object

      • scale_up_secondsinteger | null

        Warm-up time before saturation counts against the lane.

      • overflow_policyenum

        What happens once saturated.

        "reject""throttle"null
      • max_concurrencyinteger | null

        Declared cap on in-flight requests for this model.

    • throughput_tpsnumber | nullrequired

      Observed output tokens per second from real traffic.

    • stats_sourcestring | nullrequired
    • rate_limitsobject | nullrequired

      Declared and observed per-account rate limits for this wire id (observed, not enforced).

      rate_limits
      • requests_per_minuteinteger | null
      • tokens_per_minuteinteger | null
      • observed_requests_per_minuteinteger | null
      • observed_tokens_per_minuteinteger | null
    • ramp_statestring | nullrequired

      Rollout stage, for example canary (limited rollout).

    • statusstringrequired

      Lane serving status: active is listed and callable, disabled is unlisted.

    • ladder_rankinteger | null

      Position among this model's public lanes (display only, never a routing input).

    • ladder_lane_countinteger | null
    • ladder_scorenumber | null
    • ladder_factorsobject | null

      Score breakdown keyed by factor: reliability, ttft, decode, input_cost, output_cost.

    • rollout_progressobject | null

      For a canary lane, progress toward automatic promotion to full rollout.

      rollout_progress
      • min_requestsintegerrequired
      • min_reliability_pctnumberrequired
      • observed_requestsintegerrequired

        Successful requests in the observed window.

      • reliability_pctnumber | nullrequired
      • promote_eligiblebooleanrequired

        True when the lane clears the bar; the next scheduled run promotes it.

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

  • 403

    The key is valid but may not perform this action (for example an inference key on a provisioning-key route, or a feature outside your plan).

    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 org operates no provider, or the lane is not one of its public lanes.

    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

    The lane is not servable yet, or the body failed validation.

Request

curl -X PUT https://api.experientiallabs.ai/api/orgs/3f6c2a1e-8b7d-4c2a-9e51-6a0d4b2f7c10/provider/lanes/7c1e9a52-4b3d-4f0e-a8c6-2d5b9e1f0a37/listing \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "listed": true
}'

Response

{
  "lane_id": "7c1e9a52-4b3d-4f0e-a8c6-2d5b9e1f0a37",
  "model_slug": "llama-4.1-70b-instruct",
  "model_display_name": "Llama 4.1 70B Instruct",
  "wire_id": "meta-llama/llama-4.1-70b-instruct",
  "prices": {
    "input_nano_usd_per_million": 350000000,
    "cached_input_nano_usd_per_million": 35000000,
    "output_nano_usd_per_million": 900000000,
    "reasoning_nano_usd_per_million": null
  },
  "data_policy": {
    "retains_prompts": false,
    "retention_days": null,
    "trains_on_data": false,
    "zero_data_retention": true,
    "policy_url": null
  },
  "dispatch": null,
  "throughput_tps": null,
  "stats_source": null,
  "rate_limits": null,
  "ramp_state": "canary",
  "status": "active",
  "ladder_rank": null,
  "ladder_lane_count": null,
  "ladder_score": null,
  "ladder_factors": null,
  "rollout_progress": {
    "min_requests": 500,
    "min_reliability_pct": 98,
    "observed_requests": 0,
    "reliability_pct": null,
    "promote_eligible": false
  }
}

https://api.experientiallabs.ai/api/orgs/3f6c2a1e-8b7d-4c2a-9e51-6a0d4b2f7c10/provider/lanes/7c1e9a52-4b3d-4f0e-a8c6-2d5b9e1f0a37/listing