/api/models/{slug}/providers/{provider_row_id}/endpoint-credentialRotate or clear an endpoint API key
Applies only to a local deployment your organization owns on this model; any other id answers 404 so existence does not leak. The key is write-only (stored in a vault; only endpoint_credential_last4 is ever returned). endpoint_api_key: null clears it, after which the gateway sends a placeholder bearer. The gateway picks the change up within one refresh interval.
認証: AuthorizationヘッダーにBearer形式のAPIキー
パスパラメータ
slugstring必須Model slug.
provider_row_idstring必須Deployment id (the
idfromGET /api/models/{slug}/providers).
リクエストボディ
org_idstring | nullImplied by a key.
endpoint_api_keystring | nullThe new key; null clears it.
レスポンス
200The deployment with its new masked key.
レスポンス
idstringDeployment id, or
byok:{connection_id}for a lane served by your own provider connection. This is the token a waterfall write uses.model_idstringproviderstringProvider id as shown to you; platform lanes run on our own capacity show
experiential_cloud.provider_model_idstringThe provider's wire id.
base_urlstring | nullEndpoint of a customer-run (
local,modal) deployment.regionstring | nullapi_versionstring | nullowning_org_idstring | nullYour organization for a private lane; null for a public lane.
provider_connection_idstring | nullThe pinned BYOK connection, if any.
connection_aliasstring | nullOn BYOK lanes only: the connection's account alias, which tells two same-provider accounts apart.
route_idstring | nullOpaque per-organization handle for selecting exactly this lane on a request. Null without an organization context or when the lane cannot serve your traffic.
provider_statusobjectThe provider's own public status report for this lane. Advisory only, never routing input.
provider_status
stateenumofficial_urlstring | nullchecked_atstring | nullscopestringlimitationstringincidentsarray<object>advisoryboolean
provider_logo_urlstringRegistry provider logo, when one exists. Omitted otherwise.
billing_sourceenumhost_managedbills your credits;customer_managedbills your own provider or endpoint.input_nano_usd_per_millioninteger | nullcached_input_nano_usd_per_millioninteger | nullcache_write_input_nano_usd_per_millioninteger | nullcache_write_1h_input_nano_usd_per_millioninteger | nulllong_context_cache_write_input_nano_usd_per_millioninteger | nulllong_context_cache_write_1h_input_nano_usd_per_millioninteger | nullcache_write_12h_input_nano_usd_per_millioninteger | nullNull on a lane supporting 12-hour cache means 2.5 times the input rate.
output_nano_usd_per_millioninteger | nullreasoning_nano_usd_per_millioninteger | nullimage_output_nano_usd_per_millioninteger | nullGenerated-image tokens rate; null bills them as output.
long_context_threshold_tokensinteger | nullOnce reported input tokens reach this, the
long_context_*rates price the whole request. Null means flat pricing.long_context_input_nano_usd_per_millioninteger | nulllong_context_cached_input_nano_usd_per_millioninteger | nulllong_context_output_nano_usd_per_millioninteger | nulllong_context_reasoning_nano_usd_per_millioninteger | nullunit_pricesobjectA per-unit lane's only meter.
unit_prices
kindenumratesobjectInteger nano-USD per unit by variant (
""is the flat rate).
off_peak_pricingobjectOff-peak price card with its weekly UTC peak windows (
prices,peak_windows,off_peak_dates). The headline rates are the peak price. Omitted when absent.pricing_sourcestring | nullpricing_effective_atstring | nullcapabilitiesobjectWire capabilities the gateway enforces (for example
supports_tools,supported_reasoning_efforts).uptime_30dnumber | nullPercent.
uptime_recentnumber | nullCompleted share (percent) of the route's most recent requests; null under 50 requests.
uptime_recent_requestsinteger | nullthroughput_tpsnumber | nullObserved decode tokens per second.
latency_p50_msnumber | nullObserved median time to first token.
request_latency_p50_msnumber | nullObserved median end-to-end latency of calls with no first token.
stats_sourceenumstatusstringroutableboolean | nullWhether the gateway's active plan routes this platform lane. Null when not applicable.
requires_paymentbooleanPaid-only lane (a completed top-up opens it).
requires_purchasebooleanPurchase-required lane (a real purchase, not the $1 verification, opens it).
zdr_onlybooleanServes only requests routed under zero data retention.
hidden_fallbackbooleanavailable_to_orgboolean | nullWhether your organization may use this closed lane. Null without an organization context or for an open lane.
zero_data_retentionboolean | nullDetail route only. Null means no posture coverage, which a require-ZDR policy treats as non-compliant.
zero_data_retention_on_requestboolean | nullZDR only when dispatched under the gateway's per-request ZDR constraint.
processing_region_setsarray<array<string>>plan_discountsobject | nullいずれか
object
freenumberpronumbermaxnumberultranumber
service_tier_ratesobject | nullPer-tier rate cards (
flex,priority) in nano-USD per million tokens when the lane prices processing tiers.ladder_rankinteger | nullDisplay-only position among the model's public platform lanes.
ladder_lane_countinteger | nullladder_scorenumber | nullladder_factorsobject | nullendpoint_credential_last4string | nullLast four characters of a stored endpoint API key.
created_atstringupdated_atstring
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).
404The model is not visible, or the id is not a customer-run deployment of it in your organization.
レスポンス
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).
409Clearing the key of a deployment whose keyed create has not finished (retry the create first), or the row changed mid-request.
レスポンス
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).
422The body or query failed validation.
レスポンス
detailarray<object>必須detail
typestringlocarray<string | integer>msgstring
リクエスト
curl -X PUT https://api.experientiallabs.ai/api/models/my-local-model/providers/5d2e9a71-3b4c-4f80-8e16-2a9c7b0d4e53/endpoint-credential \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"endpoint_api_key": "sk-acme-endpoint-rotated-2b8d6f"
}'レスポンス
{
"id": "5d2e9a71-3b4c-4f80-8e16-2a9c7b0d4e53",
"model_id": "0b8f3d2a-5c61-4e7f-9a12-7d4e6b1c9f30",
"provider": "local",
"provider_model_id": "my-model",
"base_url": "https://models.acme.dev:8000/v1",
"region": null,
"api_version": null,
"owning_org_id": "3f6c2a1e-8b7d-4c2a-9e51-6a0d4b2f7c10",
"provider_connection_id": null,
"billing_source": "customer_managed",
"pricing_source": "self-reported",
"capabilities": {
"supports_temperature": true,
"supports_tools": true
},
"status": "active",
"endpoint_credential_last4": "6f2b",
"created_at": "2026-11-19T15:02:11.104512+00:00",
"updated_at": "2026-11-19T16:20:03.918274+00:00"
}https://api.experientiallabs.ai/api/models/my-local-model/providers/5d2e9a71-3b4c-4f80-8e16-2a9c7b0d4e53/endpoint-credential