/api/orgs/{org_id}/provider/requestsFile a change request
add_models applies at once when two gates pass: the manifest review against the live catalog, then a real streamed completion against your endpoint for every wire id (with the stored house key, or smoke_api_key, which authenticates the probe only and is never stored). Either failure answers 400 and lists nothing; new lanes land unlisted, so list each one afterwards. update_prices and update_model also apply at once (update_model at most once per 24 hours, else 429); update_limits lands pending for platform review. Org admin session or the org's own key.
Authentication: Bearer API key in the Authorization header
Path parameters
org_idstringrequiredYour organization id (uuid).
GET /api/whoamireturns it.
Request body
kindenumrequiredpayloadobjectrequiredThe shape
kindselects.One of
add_models
modelsarray<any>requiredWire ids must be unique, and no two entries may propose the same new model slug.
models
wire_idstringrequiredThe model id your endpoint accepts in
model.bindingobjectrequiredBind to a catalog model (
existing) or propose a new one (new).One of
object
kindstringrequiredslugstringrequiredAn existing catalog model slug.
object
kindstringrequiredmodelobjectrequiredmodel
slugstringrequireddisplay_namestringrequireddescriptionstring | nullcontext_windowinteger | nullmax_output_tokensinteger | nullinput_modalitiesarray<enum>huggingface_urlstring | nullExactly https://huggingface.co//.
release_urlstring | nullhttps URL with a real dotted host.
pricesobjectrequiredPer-million-token rates in integer nano-USD (1 USD = 1,000,000,000 nano-USD). Each rate is at most 1,000,000,000,000 ($1,000 per million tokens).
prices
input_nano_usd_per_millionintegerrequiredoutput_nano_usd_per_millionintegerrequiredcached_input_nano_usd_per_millioninteger | nullCached input rate; null means no cached rate.
reasoning_nano_usd_per_millioninteger | nulleffective_atstring | nullOptional timestamp with a timezone offset.
capabilitiesobjectDeclared capability booleans. Keys must come from the gateway's capability vocabulary (for example
supports_streaming,supports_parallel_tool_calls,supports_structured_text,supports_image_input,reports_cached_input_tokens,reports_reasoning_tokens); unknown keys are refused. A lane needssupports_streaming: trueto be listed.context_windowinteger | nullregionstring | nulldeprecationobject | nulldeprecation
eol_atstringrequiredreplacement_slugstring | null
data_policyobject | nullPer-model data handling. Required on every model in an application.
One of
object
retains_promptsbooleanrequiredretention_daysinteger | nullDays prompts are kept.
trains_on_databooleanrequiredzero_data_retentionbooleanrequiredpolicy_urlstring | nullPublic https URL of the policy.
dispatchobject | nullOne of
object
scale_up_secondsinteger | nullWarm-up time before saturation counts against the lane.
overflow_policyenumWhat happens once saturated.
max_concurrencyinteger | nullDeclared cap on in-flight requests for this model.
rpminteger | nullRequests per minute dispatch limit for the new lane; omit for the default.
tpminteger | nullTokens per minute dispatch limit for the new lane; omit for the default.
service_tier_pricing_enabledboolean | nullservice_tier_ratesobject | nullOne of
object
flexobject | nullOne of
object
inputinteger | nullcached_inputinteger | nullcache_creation_inputinteger | nullcache_creation_1h_inputinteger | nulloutputinteger | nullreasoninginteger | nulllong_contextobject | nulllong_context
input_threshold_tokensintegerrequiredinputinteger | nullcached_inputinteger | nullcache_creation_inputinteger | nullcache_creation_1h_inputinteger | nulloutputinteger | nullreasoninginteger | null
priorityobject | nullOne of
object
inputinteger | nullcached_inputinteger | nullcache_creation_inputinteger | nullcache_creation_1h_inputinteger | nulloutputinteger | nullreasoninginteger | nulllong_contextobject | nulllong_context
input_threshold_tokensintegerrequiredinputinteger | nullcached_inputinteger | nullcache_creation_inputinteger | nullcache_creation_1h_inputinteger | nulloutputinteger | nullreasoninginteger | null
update_prices
changesarray<object>requiredchanges
wire_idstringrequiredA wire id one of your live lanes serves.
pricesobjectrequiredPer-million-token rates in integer nano-USD (1 USD = 1,000,000,000 nano-USD). Each rate is at most 1,000,000,000,000 ($1,000 per million tokens).
prices
input_nano_usd_per_millionintegerrequiredoutput_nano_usd_per_millionintegerrequiredcached_input_nano_usd_per_millioninteger | nullCached input rate; null means no cached rate.
reasoning_nano_usd_per_millioninteger | nulleffective_atstring | nullOptional timestamp with a timezone offset.
service_tier_pricing_enabledboolean | nulltrue requires
service_tier_rates, false clears tier pricing, null leaves it unchanged.service_tier_ratesobject | nullOne of
object
flexobject | nullOne of
object
inputinteger | nullcached_inputinteger | nullcache_creation_inputinteger | nullcache_creation_1h_inputinteger | nulloutputinteger | nullreasoninginteger | nulllong_contextobject | nulllong_context
input_threshold_tokensintegerrequiredinputinteger | nullcached_inputinteger | nullcache_creation_inputinteger | nullcache_creation_1h_inputinteger | nulloutputinteger | nullreasoninginteger | null
priorityobject | nullOne of
object
inputinteger | nullcached_inputinteger | nullcache_creation_inputinteger | nullcache_creation_1h_inputinteger | nulloutputinteger | nullreasoninginteger | nulllong_contextobject | nulllong_context
input_threshold_tokensintegerrequiredinputinteger | nullcached_inputinteger | nullcache_creation_inputinteger | nullcache_creation_1h_inputinteger | nulloutputinteger | nullreasoninginteger | null
update_limits
max_concurrencyinteger | nulladvertised_tpsnumber | nullAdvertised output tokens per second.
update_model
wire_idstringrequiredpricesobject | nullOne of
object
input_nano_usd_per_millionintegerrequiredoutput_nano_usd_per_millionintegerrequiredcached_input_nano_usd_per_millioninteger | nullCached input rate; null means no cached rate.
reasoning_nano_usd_per_millioninteger | nulleffective_atstring | nullOptional timestamp with a timezone offset.
data_policyobject | nullOne of
object
retains_promptsbooleanrequiredretention_daysinteger | nullDays prompts are kept.
trains_on_databooleanrequiredzero_data_retentionbooleanrequiredpolicy_urlstring | nullPublic https URL of the policy.
dispatchobject | nullOne of
object
scale_up_secondsinteger | nullWarm-up time before saturation counts against the lane.
overflow_policyenumWhat happens once saturated.
max_concurrencyinteger | nullDeclared cap on in-flight requests for this model.
requests_per_minuteinteger | nullDeclared per-account requests per minute (observed, not enforced).
tokens_per_minuteinteger | nullDeclared per-account tokens per minute (observed, not enforced).
effective_atstring | nullRecorded on a request that lands pending (
update_limits). Must carry a timezone offset.smoke_api_keystring | nullEndpoint key for the
add_modelssmoke when no house key is stored. Used for the probe only, never stored. Ignored for other kinds.
Responses
201The recorded request:
status: appliedforadd_models,update_pricesandupdate_model,status: pendingforupdate_limits.Response
idstringrequiredkindenumrequiredstatusenumrequiredpayloadobjectrequiredThe validated payload as stored.
effective_atstring | nullrequiredreview_notestring | nullrequiredThe reviewer's note on a reviewed request.
errorstring | nullrequiredWhy an approved request failed to apply.
created_atstringrequiredapplied_atstring | nullrequired
400Refused: the manifest review found errors (
request refused: <code>: <message>; ..., for exampleunknown-wire-idon a price change), the smoke test failed (code: smoke_failed, the upstream error per wire id verbatim), or the provider has no public https base_url to probe.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).
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).
403The 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
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 resource does not exist or belongs to another organization.
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).
409An
add_modelssmoke needs a key and none is available (ahouse_keyprovider with no stored key and nosmoke_api_key), or the catalog write conflicted.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).
422The body failed validation,
payloaddoes not matchkind, anadd_modelsbatch exceeds 200 models, or the catalog refused the write.429An
update_modeledit was filed less than 24 hours after the previous one.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 -X POST https://api.experientiallabs.ai/api/orgs/3f6c2a1e-8b7d-4c2a-9e51-6a0d4b2f7c10/provider/requests \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"kind": "add_models",
"payload": {
"models": [
{
"wire_id": "meta-llama/llama-4.1-70b-instruct",
"binding": {
"kind": "existing",
"slug": "llama-4.1-70b-instruct"
},
"prices": {
"input_nano_usd_per_million": 350000000,
"output_nano_usd_per_million": 900000000,
"cached_input_nano_usd_per_million": 35000000
},
"capabilities": {
"supports_streaming": true,
"supports_parallel_tool_calls": true,
"reports_cached_input_tokens": true
},
"context_window": 131072,
"data_policy": {
"retains_prompts": false,
"trains_on_data": false,
"zero_data_retention": true
},
"rpm": 600,
"tpm": 2000000
}
]
},
"smoke_api_key": "sk-acme-probe-7d2c9e4b1a6f"
}'Response
{
"id": "8a4c2e61-7b9d-4f03-a1e5-c6d8b0f2e394",
"kind": "add_models",
"status": "applied",
"payload": {
"models": [
{
"wire_id": "meta-llama/llama-4.1-70b-instruct",
"binding": {
"kind": "existing",
"slug": "llama-4.1-70b-instruct"
},
"prices": {
"input_nano_usd_per_million": 350000000,
"output_nano_usd_per_million": 900000000,
"cached_input_nano_usd_per_million": 35000000,
"reasoning_nano_usd_per_million": null,
"effective_at": null
}
}
]
},
"effective_at": null,
"review_note": null,
"error": null,
"created_at": "2026-11-19T10:12:44.903Z",
"applied_at": "2026-11-19T10:12:44.903Z"
}https://api.experientiallabs.ai/api/orgs/3f6c2a1e-8b7d-4c2a-9e51-6a0d4b2f7c10/provider/requests