From c074a4e787a756f80d96b6e3dc3d02f6a2fd0081 Mon Sep 17 00:00:00 2001
From: "github-actions[bot]"
 <41898282+github-actions[bot]@users.noreply.github.com>
Date: Wed, 29 Jul 2026 12:54:58 +0000
Subject: [PATCH] chore: bump version to 1.0.23

---
 docs/index.html | 4 ++--
 pyproject.toml  | 2 +-
 uv.lock         | 2 +-
 3 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/docs/index.html b/docs/index.html
index 429a49a..03db9af 100644
--- a/docs/index.html
+++ b/docs/index.html
@@ -403,7 +403,7 @@
           55.627 l 55.6165,55.627 -231.245496,231.24803 c -127.185,127.1864
           -231.5279,231.248 -231.873,231.248 -0.3451,0 -104.688,
           -104.0616 -231.873,-231.248 z
-        " fill="currentColor"></path></g></svg></div></div><div class="sc-jtXGCf hrMIKQ api-content"><div class="sc-eCIkhf iodgtX"><div class="sc-iCfMpq ckjCss"><div class="sc-hKwAaq dCgkBy api-info"><h1 class="sc-furwwf sc-ctqRRG dXfdyZ pUnNY">MLPA<!-- --> <span>(<!-- -->1.0.22<!-- -->)</span></h1><p>Download OpenAPI specification<!-- -->:</p><div class="sc-iJKPnr sc-cCcWCX VOHLa fjXwIu"></div><div data-role="redoc-summary" html="" class="sc-iJKPnr sc-cCcWCX VOHLa fjXwIu"></div><div data-role="redoc-description" html="&lt;p&gt;Authenticates and proxies LLM requests through LiteLLM to enact budgets and per-user management.&lt;/p&gt;
+        " fill="currentColor"></path></g></svg></div></div><div class="sc-jtXGCf hrMIKQ api-content"><div class="sc-eCIkhf iodgtX"><div class="sc-iCfMpq ckjCss"><div class="sc-hKwAaq dCgkBy api-info"><h1 class="sc-furwwf sc-ctqRRG dXfdyZ pUnNY">MLPA<!-- --> <span>(<!-- -->1.0.23<!-- -->)</span></h1><p>Download OpenAPI specification<!-- -->:</p><div class="sc-iJKPnr sc-cCcWCX VOHLa fjXwIu"></div><div data-role="redoc-summary" html="" class="sc-iJKPnr sc-cCcWCX VOHLa fjXwIu"></div><div data-role="redoc-description" html="&lt;p&gt;Authenticates and proxies LLM requests through LiteLLM to enact budgets and per-user management.&lt;/p&gt;
 " class="sc-iJKPnr sc-cCcWCX VOHLa fjXwIu"><p>Authenticates and proxies LLM requests through LiteLLM to enact budgets and per-user management.</p>
 </div></div></div></div><div id="tag/Health" data-section-id="tag/Health" class="sc-eCIkhf iodgtX"><div class="sc-iCfMpq ckjCss"><div class="sc-hKwAaq dCgkBy"><h2 class="sc-pVTZz ecITPE"><a class="sc-crHjuH bWKACQ" href="#tag/Health" aria-label="tag/Health"></a>Health</h2></div></div><div class="sc-hKwAaq dSwTzC"><div class="sc-iJKPnr sc-cCcWCX VOHLa fjXwIu redoc-markdown " html="&lt;p&gt;Health check endpoints.&lt;/p&gt;
 "><p>Health check endpoints.</p>
@@ -613,7 +613,7 @@
 " class="sc-iJKPnr sc-cCcWCX sc-cidBVM VOHLa fMmaro kCvENa"><p>Validation Error</p>
 </div></button></div></div></div><div class="sc-jRQzZg sc-gKckfV hRjYfJ eUQYbB"><div class="sc-fXErLa bbWiYP"><button class="sc-jWUChQ erRBwE"><span type="get" class="sc-eFeklB emmCUp http-verb get">get</span><span class="sc-FNZOL diNGLU">/user/{user_id}</span><svg class="sc-eggEi hpWRWC" style="margin-right:-25px" version="1.1" viewBox="0 0 24 24" x="0" xmlns="http://www.w3.org/2000/svg" y="0" aria-hidden="true"><polygon points="17.3 8.3 12 13.6 6.7 8.3 5.3 9.7 12 16.4 18.7 9.7 "></polygon></svg></button><div aria-hidden="true" class="sc-fmBBaG gNOWMI"><div class="sc-lkgSDn cWkJHf"><div html="" class="sc-iJKPnr sc-cCcWCX VOHLa hqXESs"></div><div tabindex="0" role="button"><div class="sc-jlRLxw PQwbl"><span></span>/user/{user_id}</div></div></div></div></div><div><h3 class="sc-kDTkih epmtjy"> <!-- -->Response samples<!-- --> </h3><div class="sc-cxpTYp dMPVWi" data-rttabs="true"><ul class="react-tabs__tab-list" role="tablist"><li class="tab-success react-tabs__tab--selected" role="tab" id="tab_R_jjka_0" aria-selected="true" aria-disabled="false" aria-controls="panel_R_jjka_0" tabindex="0" data-rttab="true">200</li><li class="tab-error" role="tab" id="tab_R_jjka_1" aria-selected="false" aria-disabled="false" aria-controls="panel_R_jjka_1" data-rttab="true">404</li><li class="tab-error" role="tab" id="tab_R_jjka_2" aria-selected="false" aria-disabled="false" aria-controls="panel_R_jjka_2" data-rttab="true">422</li></ul><div class="react-tabs__tab-panel react-tabs__tab-panel--selected" role="tabpanel" id="panel_R_jjka_0" aria-labelledby="tab_R_jjka_0"><div><div class="sc-cNKpcR kfsgQ"><span class="sc-bBHFCG hlWAis">Content type</span><div class="sc-dPiItf gqhCHD">application/json</div></div><div class="sc-hUpbJy iMrUjm"><div class="sc-cTAnsW lhfojE"><div class="sc-giYhsS gIWUEs"><button><div class="sc-jcFjLp iOHkbi">Copy</div></button></div><div tabindex="0" class="sc-iJKPnr VOHLa sc-jObViz hrGEtd"><div class="redoc-json"><code><span class="token keyword">null</span></code></div></div></div></div></div></div><div class="react-tabs__tab-panel" role="tabpanel" id="panel_R_jjka_1" aria-labelledby="tab_R_jjka_1"></div><div class="react-tabs__tab-panel" role="tabpanel" id="panel_R_jjka_2" aria-labelledby="tab_R_jjka_2"></div></div></div></div></div></div></div><div class="sc-eldhKs kKhYHc"></div></div></div>
       <script>
-      const __redoc_state = {"menu":{"activeItemIdx":-1},"spec":{"data":{"openapi":"3.1.0","info":{"title":"MLPA","description":"Authenticates and proxies LLM requests through LiteLLM to enact budgets and per-user management.","version":"1.0.22"},"paths":{"/metrics":{"get":{"tags":["Metrics"],"summary":"Get Metrics","operationId":"get_metrics_metrics_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/health/liveness":{"get":{"tags":["Health"],"summary":"Liveness Probe","operationId":"liveness_probe_health_liveness_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/health/readiness":{"get":{"tags":["Health"],"summary":"Readiness Probe","operationId":"readiness_probe_health_readiness_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/verify/challenge":{"get":{"tags":["App Attest"],"summary":"Get attestation challenge","description":"Generate a challenge for iOS App Attest. The client uses this challenge when creating an attestation key. Call this first, then POST the attestation to /verify/attest.","operationId":"get_challenge_verify_challenge_get","parameters":[{"name":"key_id_b64","in":"query","required":true,"schema":{"type":"string","description":"Base64-encoded attestation key ID from the iOS device","title":"Key Id B64"},"description":"Base64-encoded attestation key ID from the iOS device"}],"responses":{"200":{"description":"Challenge generated successfully","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ChallengeResponse"}}}},"400":{"description":"Bad Request - Missing or invalid key_id_b64"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/verify/attest":{"post":{"tags":["App Attest"],"summary":"Verify attestation","description":"Submit the App Attest attestation object for verification. Authorization must be a Bearer JWT whose payload matches the AttestationAuth schema. Use the challenge from GET /verify/challenge.","operationId":"attest_verify_attest_post","parameters":[{"name":"authorization","in":"header","required":true,"schema":{"type":"string","description":"Bearer JWT with payload matching AttestationAuth schema","title":"Authorization"},"description":"Bearer JWT with payload matching AttestationAuth schema"},{"name":"use-qa-certificates","in":"header","required":false,"schema":{"anyOf":[{"type":"boolean"},{"type":"null"}],"description":"Use QA certificates (set to true for development/sandbox testing)","title":"Use-Qa-Certificates"},"description":"Use QA certificates (set to true for development/sandbox testing)"}],"responses":{"201":{"description":"Attestation verified successfully","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AttestSuccessResponse"}}}},"400":{"description":"Bad Request - Invalid base64 in JWT payload"},"401":{"description":"Unauthorized - Invalid or expired challenge, or invalid attestation"},"403":{"description":"Forbidden - Attestation verification failed"},"422":{"description":"Unprocessable Entity - Missing required Authorization header"}}}},"/verify/play":{"post":{"tags":["Play Integrity"],"summary":"Verify Play Integrity","operationId":"verify_play_integrity_verify_play_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlayIntegrityRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlayIntegrityTokenResponse"}}}},"401":{"description":"Unauthorized - the Play Integrity check did not pass. The token, package name, request hash, or the app/device verdicts failed verification. `detail` is a string for verdict failures, or an object like `{\"error\": ...}` when the upstream Play Integrity API rejects the token.","content":{"application/json":{"schema":{"properties":{"detail":{"anyOf":[{"type":"string"},{"properties":{"error":{"type":"string"}},"type":"object"}]}},"type":"object","required":["detail"]},"examples":{"verdict_failed":{"summary":"Verdict failed (string detail)","value":{"detail":"Invalid Play Integrity token"}},"upstream_rejected":{"summary":"Upstream Play API rejected the token (object detail)","value":{"detail":{"error":"Upstream service returned an error"}}}}}}},"403":{"description":"Forbidden - the requested package name is not allowed.","content":{"application/json":{"schema":{"properties":{"detail":{"type":"string"}},"type":"object","required":["detail"]},"example":{"detail":"Package name not allowed"}}}},"422":{"description":"Validation Error - the request body did not match the schema, for example a missing or wrong-typed field. FastAPI returns this before the handler runs, so it is not an auth failure (those return 401).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"502":{"description":"Bad Gateway - the Play Integrity validation service is unavailable.","content":{"application/json":{"schema":{"properties":{"detail":{"properties":{"error":{"type":"string"}},"type":"object"}},"type":"object","required":["detail"]},"example":{"detail":{"error":"Play Integrity validation service unavailable"}}}}}}}},"/user":{"get":{"tags":["User Management"],"summary":"List Users","description":"List all users with pagination support.","operationId":"list_users_user_get","parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":200,"minimum":1,"default":50,"title":"Limit"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"default":0,"title":"Offset"}},{"name":"master-key","in":"header","required":true,"schema":{"type":"string","title":"Master Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"401":{"description":"Unauthorized - the master_key or mlpa_ui_access_key header is missing or wrong.","content":{"application/json":{"schema":{"type":"object","properties":{"detail":{"type":"object","properties":{"error":{"type":"string"}}}},"required":["detail"]},"example":{"detail":{"error":"Unauthorized"}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/user/counts-by-service-type":{"get":{"tags":["User Management"],"summary":"Count Users By Service Type","description":"Get total user counts grouped by service_type (MLPA_UI_ACCESS_KEY, not MASTER_KEY).","operationId":"count_users_by_service_type_user_counts_by_service_type_get","parameters":[{"name":"mlpa-ui-access-key","in":"header","required":true,"schema":{"type":"string","title":"Mlpa Ui Access Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"401":{"description":"Unauthorized - the master_key or mlpa_ui_access_key header is missing or wrong.","content":{"application/json":{"schema":{"type":"object","properties":{"detail":{"type":"object","properties":{"error":{"type":"string"}}}},"required":["detail"]},"example":{"detail":{"error":"Unauthorized"}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/user/signup-cap-status":{"get":{"tags":["User Management"],"summary":"Signup Cap Status","description":"Managed signup capacity for capped service types (MLPA_UI_ACCESS_KEY).","operationId":"signup_cap_status_user_signup_cap_status_get","parameters":[{"name":"mlpa-ui-access-key","in":"header","required":true,"schema":{"type":"string","title":"Mlpa Ui Access Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"401":{"description":"Unauthorized - the master_key or mlpa_ui_access_key header is missing or wrong.","content":{"application/json":{"schema":{"type":"object","properties":{"detail":{"type":"object","properties":{"error":{"type":"string"}}}},"required":["detail"]},"example":{"detail":{"error":"Unauthorized"}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/user/{user_id}":{"get":{"tags":["User"],"summary":"User Info","operationId":"user_info_user__user_id__get","parameters":[{"name":"user_id","in":"path","required":true,"schema":{"type":"string","title":"User Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"404":{"description":"User not found.","content":{"application/json":{"schema":{"type":"object","properties":{"detail":{"type":"string"}},"required":["detail"]},"example":{"detail":"User not found"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/user/{user_id}/budget":{"post":{"tags":["User Management"],"summary":"Update User Budget","description":"Update a user's budget tier by service type (e.g. ai-dev for higher limits).","operationId":"update_user_budget_user__user_id__budget_post","parameters":[{"name":"user_id","in":"path","required":true,"schema":{"type":"string","title":"User Id"}},{"name":"master-key","in":"header","required":true,"schema":{"type":"string","title":"Master Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BudgetUpdatePayload"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"401":{"description":"Unauthorized - the master_key or mlpa_ui_access_key header is missing or wrong.","content":{"application/json":{"schema":{"type":"object","properties":{"detail":{"type":"object","properties":{"error":{"type":"string"}}}},"required":["detail"]},"example":{"detail":{"error":"Unauthorized"}}}}},"404":{"description":"User not found.","content":{"application/json":{"schema":{"type":"object","properties":{"detail":{"type":"string"}},"required":["detail"]},"example":{"detail":"User not found"}}}},"422":{"description":"Unprocessable Entity. Two things return this status: an unknown service type in the payload, where `detail` is an object like `{\"error\": ...}`, and FastAPI body validation, where `detail` is a list like `[{\"loc\", \"msg\", ...}]`.","content":{"application/json":{"schema":{"type":"object","properties":{"detail":{"anyOf":[{"type":"object","properties":{"error":{"type":"string"}}},{"type":"array","items":{"type":"object"}}]}},"required":["detail"]},"examples":{"unknown_service_type":{"summary":"Unknown service type (object detail)","value":{"detail":{"error":"Unknown service type: foo. Valid values: ai, ai-dev, ..."}}},"request_validation":{"summary":"Request body validation (list detail)","value":{"detail":[{"loc":["body","service_type"],"msg":"Field required","type":"missing"}]}}}}}}}}},"/user/{user_id}/block":{"post":{"tags":["User Management"],"summary":"Block User","description":"Block a user by their user_id.","operationId":"block_user_user__user_id__block_post","parameters":[{"name":"user_id","in":"path","required":true,"schema":{"type":"string","title":"User Id"}},{"name":"master-key","in":"header","required":true,"schema":{"type":"string","title":"Master Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"401":{"description":"Unauthorized - the master_key or mlpa_ui_access_key header is missing or wrong.","content":{"application/json":{"schema":{"type":"object","properties":{"detail":{"type":"object","properties":{"error":{"type":"string"}}}},"required":["detail"]},"example":{"detail":{"error":"Unauthorized"}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/user/{user_id}/unblock":{"post":{"tags":["User Management"],"summary":"Unblock User","description":"Unblock a user by their user_id.","operationId":"unblock_user_user__user_id__unblock_post","parameters":[{"name":"user_id","in":"path","required":true,"schema":{"type":"string","title":"User Id"}},{"name":"master-key","in":"header","required":true,"schema":{"type":"string","title":"Master Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"401":{"description":"Unauthorized - the master_key or mlpa_ui_access_key header is missing or wrong.","content":{"application/json":{"schema":{"type":"object","properties":{"detail":{"type":"object","properties":{"error":{"type":"string"}}}},"required":["detail"]},"example":{"detail":{"error":"Unauthorized"}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/mock/chat/completions":{"post":{"tags":["Mock"],"summary":"Chat Completion","description":"Mock LiteLLM endpoint with simulated latency.","operationId":"chat_completion_mock_chat_completions_post","parameters":[{"name":"authorization","in":"header","required":true,"schema":{"type":"string","title":"Authorization"}},{"name":"service-type","in":"header","required":true,"schema":{"$ref":"#/components/schemas/ServiceType"}},{"name":"purpose","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Purpose"}},{"name":"x-dev-authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Dev-Authorization"}},{"name":"use-app-attest","in":"header","required":false,"schema":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Use-App-Attest"}},{"name":"use-qa-certificates","in":"header","required":false,"schema":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Use-Qa-Certificates"}},{"name":"use-play-integrity","in":"header","required":false,"schema":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Use-Play-Integrity"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ChatRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/mock/chat/completions_no_auth":{"post":{"tags":["Mock"],"summary":"Chat Completion No Auth","description":"Mock LiteLLM endpoint with simulated latency and JWT-only token validation (no POST calls).","operationId":"chat_completion_no_auth_mock_chat_completions_no_auth_post","parameters":[{"name":"authorization","in":"header","required":true,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ChatRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/chat/completions":{"post":{"tags":["LiteLLM"],"summary":"Chat Completion","description":"Authorize first using App Attest, Play Integrity, FxA, or dev tier.\n\n**Headers:**\n\n- **Authorization** (required): Bearer token — FxA OAuth token, Play Integrity MLPA token, or App Attest JWT.\n- **service-type** (required): One of `ai`, `s2s`, `s2s-android`, `memories`, `ai-dev`, `memories-dev`, `mochi-dev`, `answer`, `telemetry` — for tracking and budget.\n- **purpose** (required for ai/ai-dev/mochi-dev/memories/memories-dev): One of `chat`, `title-generation`, `convo-starters-sidebar` for AI; `memory-generation` for memories; omit for s2s.\n- **x-dev-authorization** (required for ai-dev/memories-dev/mochi-dev): Experimentation token; also requires FxA in Authorization. Dev service types return 401 without it.\n- **use-app-attest**: Set to `true` for iOS App Attest.\n- **use-play-integrity**: Set to `true` for Android Play Integrity.","operationId":"chat_completion_v1_chat_completions_post","parameters":[{"name":"authorization","in":"header","required":true,"schema":{"type":"string","title":"Authorization"},"description":"Bearer token: FxA OAuth, Play Integrity MLPA token, or App Attest JWT."},{"name":"service-type","in":"header","required":true,"schema":{"type":"string","enum":["ai","s2s","s2s-android","memories","answer","telemetry","agent","ai-dev","memories-dev","mochi-dev"],"title":"Service-Type"},"description":"Service type for tracking and budget. Use ai-dev, memories-dev, or mochi-dev for experiments (higher limits)."},{"name":"purpose","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Purpose"},"description":"Purpose for Prometheus and product tracking. Optional (validated if provided). AI: chat, title-generation, convo-starters-sidebar. Memories: memory-generation. Omit or leave empty for s2s, s2s-android."},{"name":"x-dev-authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Dev-Authorization"},"description":"Required for ai-dev/memories-dev/mochi-dev. Experimentation token; also requires Authorization (FxA). Without it, dev service types return 401."},{"name":"use-app-attest","in":"header","required":false,"schema":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Use-App-Attest"},"description":"Optional. Set to true for iOS App Attest; Authorization must contain AssertionAuth JWT."},{"name":"use-qa-certificates","in":"header","required":false,"schema":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Use-Qa-Certificates"},"description":"Optional. For App Attest QA/sandbox testing."},{"name":"use-play-integrity","in":"header","required":false,"schema":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Use-Play-Integrity"},"description":"Optional. Set to true for Android Play Integrity; Authorization contains MLPA token from /verify/play."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ChatRequest"}}}},"responses":{"200":{"description":"OpenAI-compatible chat completion. Returns a JSON completion object, or a `text/event-stream` of SSE chunks when `stream` is `true`.","content":{"application/json":{"schema":{}},"text/event-stream":{}}},"400":{"description":"Bad Request - Invalid model name or malformed request body","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"integer","description":"Error code: 8 invalid model name, 9 invalid request body"}},"required":["error"]},"examples":{"invalid_model_name":{"summary":"Invalid model name","value":{"error":8},"description":"Requested model is not configured in LiteLLM."},"invalid_request":{"summary":"Invalid request body","value":{"error":9},"description":"Upstream rejected the request as malformed (e.g. invalid JSON body)."}}}}},"401":{"description":"Unauthorized - authentication failed or was missing. Either the Authorization header is absent, the FxA / App Attest / Play Integrity credentials did not verify, or the x-dev-authorization token is wrong for a dev service type.","content":{"application/json":{"schema":{"type":"object","properties":{"detail":{"type":"string","description":"Human-readable reason the request was not authorized."}},"required":["detail"]},"examples":{"missing_authorization_header":{"summary":"Missing authorization header","value":{"detail":"Missing authorization header"}},"invalid_fxa_auth":{"summary":"Invalid FxA auth","value":{"detail":"Invalid FxA auth"}},"invalid_dev_authorization":{"summary":"Invalid dev authorization","value":{"detail":"Invalid x-dev-authorization"}}}}}},"403":{"description":"Forbidden - Maximum signed-in users reached","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"integer","description":"Error code: 4 for maximum signed-in users reached"}},"required":["error"]},"examples":{"max_users_reached":{"summary":"Maximum signed-in users reached","value":{"error":4},"description":"New sign-ins for cap-managed service types are rejected because capacity is full."}}}}},"413":{"description":"Payload Too Large - Request body or context exceeded","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"integer","description":"Error code: 3 for request/context too large"}},"required":["error"]},"example":{"error":3}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"429":{"description":"Too Many Requests — budget or rate limit exceeded from MLPA/LiteLLM, or HTTP 429 from the Fastly WAF in front of MLPA (body `error`: 6).","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"integer","description":"Error code: 1 budget limit exceeded, 2 rate limit (TPM/RPM), 5 upstream provider rate limit, 6 Fastly WAF rate limit (edge; not from MLPA)"}},"required":["error"]},"examples":{"budget_exceeded":{"summary":"Budget limit exceeded","value":{"error":1},"description":"Budget limit exceeded. Check Retry-After header (86400 seconds = 1 day)."},"rate_limit_exceeded":{"summary":"Rate limit exceeded","value":{"error":2},"description":"Rate limit exceeded (TPM/RPM). Check Retry-After header (60 seconds)."},"upstream_rate_limit_exceeded":{"summary":"Upstream rate limit exceeded","value":{"error":5},"description":"Upstream provider rate limit exceeded."},"fastly_waf_rate_limit":{"summary":"Fastly WAF rate limit","value":{"error":6},"description":"HTTP 429 returned at the Fastly edge (WAF) before the request reaches MLPA. "}}}},"headers":{"Retry-After":{"description":"Number of seconds to wait before retrying","schema":{"type":"string","example":"86400"}}}}}}},"/v1/search":{"post":{"tags":["LiteLLM"],"summary":"Search","description":"Web search proxied to Exa via LiteLLM. Authorize the same way as /v1/chat/completions.\n\n**Headers:**\n\n- **Authorization** (required): Bearer token — FxA OAuth token, Play Integrity MLPA token, or App Attest JWT.\n- **service-type**: `search` by default; use `search-dev` for experiments. Search has its own budget pool and no `purpose` header.\n- **x-dev-authorization** (required for search-dev): Experimentation token; also requires FxA in Authorization.\n\n**Body:** `{\"query\": str, \"max_results\": int (1-10)}`.","operationId":"search_v1_search_post","parameters":[{"name":"authorization","in":"header","required":true,"schema":{"type":"string","title":"Authorization"}},{"name":"service-type","in":"header","required":false,"schema":{"type":"string","enum":["search","search-dev"],"default":"search","title":"Service-Type"},"description":"Service type for search requests. Use search-dev for experiments; it requires x-dev-authorization."},{"name":"purpose","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Purpose"}},{"name":"x-dev-authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Dev-Authorization"},"description":"Required when service-type is search-dev. Experimentation token; also requires Authorization (FxA)."},{"name":"use-app-attest","in":"header","required":false,"schema":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Use-App-Attest"}},{"name":"use-qa-certificates","in":"header","required":false,"schema":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Use-Qa-Certificates"}},{"name":"use-play-integrity","in":"header","required":false,"schema":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Use-Play-Integrity"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SearchRequest"}}}},"responses":{"200":{"description":"Search results returned from the Exa search backend.","content":{"application/json":{"schema":{}}}},"400":{"description":"Bad Request - Invalid model name or malformed request body","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"integer","description":"Error code: 8 invalid model name, 9 invalid request body"}},"required":["error"]},"examples":{"invalid_model_name":{"summary":"Invalid model name","value":{"error":8},"description":"Requested model is not configured in LiteLLM."},"invalid_request":{"summary":"Invalid request body","value":{"error":9},"description":"Upstream rejected the request as malformed (e.g. invalid JSON body)."}}}}},"401":{"description":"Unauthorized - authentication failed or was missing. Either the Authorization header is absent, the FxA / App Attest / Play Integrity credentials did not verify, or the x-dev-authorization token is wrong for a dev service type.","content":{"application/json":{"schema":{"type":"object","properties":{"detail":{"type":"string","description":"Human-readable reason the request was not authorized."}},"required":["detail"]},"examples":{"missing_authorization_header":{"summary":"Missing authorization header","value":{"detail":"Missing authorization header"}},"invalid_fxa_auth":{"summary":"Invalid FxA auth","value":{"detail":"Invalid FxA auth"}},"invalid_dev_authorization":{"summary":"Invalid dev authorization","value":{"detail":"Invalid x-dev-authorization"}}}}}},"403":{"description":"Forbidden - Maximum signed-in users reached","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"integer","description":"Error code: 4 for maximum signed-in users reached"}},"required":["error"]},"examples":{"max_users_reached":{"summary":"Maximum signed-in users reached","value":{"error":4},"description":"New sign-ins for cap-managed service types are rejected because capacity is full."}}}}},"413":{"description":"Payload Too Large - Request body or context exceeded","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"integer","description":"Error code: 3 for request/context too large"}},"required":["error"]},"example":{"error":3}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"429":{"description":"Too Many Requests — budget or rate limit exceeded from MLPA/LiteLLM, or HTTP 429 from the Fastly WAF in front of MLPA (body `error`: 6).","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"integer","description":"Error code: 1 budget limit exceeded, 2 rate limit (TPM/RPM), 5 upstream provider rate limit, 6 Fastly WAF rate limit (edge; not from MLPA)"}},"required":["error"]},"examples":{"budget_exceeded":{"summary":"Budget limit exceeded","value":{"error":1},"description":"Budget limit exceeded. Check Retry-After header (86400 seconds = 1 day)."},"rate_limit_exceeded":{"summary":"Rate limit exceeded","value":{"error":2},"description":"Rate limit exceeded (TPM/RPM). Check Retry-After header (60 seconds)."},"upstream_rate_limit_exceeded":{"summary":"Upstream rate limit exceeded","value":{"error":5},"description":"Upstream provider rate limit exceeded."},"fastly_waf_rate_limit":{"summary":"Fastly WAF rate limit","value":{"error":6},"description":"HTTP 429 returned at the Fastly edge (WAF) before the request reaches MLPA. "}}}},"headers":{"Retry-After":{"description":"Number of seconds to wait before retrying","schema":{"type":"string","example":"86400"}}}}}}}},"components":{"schemas":{"AttestSuccessResponse":{"properties":{"status":{"type":"string","title":"Status"}},"type":"object","required":["status"],"title":"AttestSuccessResponse"},"BudgetUpdatePayload":{"properties":{"service_type":{"type":"string","title":"Service Type"}},"type":"object","required":["service_type"],"title":"BudgetUpdatePayload","description":"Payload for updating a user's budget tier."},"ChallengeResponse":{"properties":{"challenge":{"type":"string","title":"Challenge"}},"type":"object","required":["challenge"],"title":"ChallengeResponse"},"ChatRequest":{"properties":{"model":{"type":"string","title":"Model"},"stream":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Stream","default":false},"messages":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Messages","default":[]},"temperature":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Temperature","default":0.1},"max_completion_tokens":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Max Completion Tokens","default":8192},"top_p":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Top P","default":0.01},"tools":{"anyOf":[{"items":{},"type":"array"},{"type":"null"}],"title":"Tools"},"tool_choice":{"anyOf":[{"type":"string"},{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Tool Choice"},"n":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"N"},"stream_options":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Stream Options"},"stop":{"anyOf":[{"type":"string"},{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Stop"},"max_tokens":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Max Tokens"},"presence_penalty":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Presence Penalty"},"frequency_penalty":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Frequency Penalty"},"logit_bias":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Logit Bias"},"response_format":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Response Format"},"seed":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Seed"},"parallel_tool_calls":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Parallel Tool Calls"},"logprobs":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Logprobs"},"top_logprobs":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Top Logprobs"},"text":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Text"}},"type":"object","required":["model"],"title":"ChatRequest"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"PlayIntegrityRequest":{"properties":{"integrity_token":{"type":"string","title":"Integrity Token"},"user_id":{"type":"string","title":"User Id"},"package_name":{"type":"string","title":"Package Name","default":"org.mozilla.firefox"}},"type":"object","required":["integrity_token","user_id"],"title":"PlayIntegrityRequest"},"PlayIntegrityTokenResponse":{"properties":{"access_token":{"type":"string","title":"Access Token"},"token_type":{"type":"string","title":"Token Type"},"expires_in":{"type":"integer","title":"Expires In"}},"type":"object","required":["access_token","token_type","expires_in"],"title":"PlayIntegrityTokenResponse","description":"Short-lived MLPA access token issued after Play Integrity verification."},"SearchRequest":{"properties":{"query":{"type":"string","title":"Query"},"max_results":{"type":"integer","maximum":10,"minimum":1,"title":"Max Results"}},"type":"object","required":["query","max_results"],"title":"SearchRequest"},"ServiceType":{"type":"string","enum":["ai","s2s","s2s-android","memories","search","answer","telemetry","agent","ai-dev","memories-dev","mochi-dev","search-dev"],"title":"ServiceType"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"},"input":{"title":"Input"},"ctx":{"type":"object","title":"Context"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"},"AttestationAuth":{"properties":{"key_id_b64":{"title":"Key Id B64","type":"string"},"challenge_b64":{"title":"Challenge B64","type":"string"},"attestation_obj_b64":{"title":"Attestation Obj B64","type":"string"},"bundle_id":{"title":"Bundle Id","type":"string"}},"required":["key_id_b64","challenge_b64","attestation_obj_b64","bundle_id"],"title":"AttestationAuth","type":"object","description":"JWT payload for POST /verify/attest"},"AssertionAuth":{"properties":{"key_id_b64":{"title":"Key Id B64","type":"string"},"challenge_b64":{"title":"Challenge B64","type":"string"},"assertion_obj_b64":{"title":"Assertion Obj B64","type":"string"},"bundle_id":{"title":"Bundle Id","type":"string"}},"required":["key_id_b64","challenge_b64","assertion_obj_b64","bundle_id"],"title":"AssertionAuth","type":"object","description":"JWT payload for POST /v1/chat/completions with use-app-attest"}}},"tags":[{"name":"Health","description":"Health check endpoints."},{"name":"Metrics","description":"Prometheus metrics endpoints."},{"name":"App Attest","description":"iOS App Attest verification flow: (1) GET /verify/challenge to obtain a challenge, (2) POST /verify/attest with a JWT containing the attestation object. Use the attested key for subsequent requests to /v1/chat/completions with use-app-attest header."},{"name":"Play Integrity","description":"Endpoints for verifying Play Integrity payloads."},{"name":"LiteLLM","description":"Endpoints for interacting with LiteLLM."},{"name":"Mock","description":"Mock endpoints for testing purposes."},{"name":"User Management","description":"Endpoints for managing user blocking status and budgets."}]}},"searchIndex":{"store":["tag/Health","tag/Health/operation/liveness_probe_health_liveness_get","tag/Health/operation/readiness_probe_health_readiness_get","tag/Metrics","tag/Metrics/operation/get_metrics_metrics_get","tag/App-Attest","tag/App-Attest/operation/get_challenge_verify_challenge_get","tag/App-Attest/operation/attest_verify_attest_post","tag/Play-Integrity","tag/Play-Integrity/operation/verify_play_integrity_verify_play_post","tag/LiteLLM","tag/LiteLLM/operation/chat_completion_v1_chat_completions_post","tag/LiteLLM/operation/search_v1_search_post","tag/Mock","tag/Mock/operation/chat_completion_mock_chat_completions_post","tag/Mock/operation/chat_completion_no_auth_mock_chat_completions_no_auth_post","tag/User-Management","tag/User-Management/operation/list_users_user_get","tag/User-Management/operation/count_users_by_service_type_user_counts_by_service_type_get","tag/User-Management/operation/signup_cap_status_user_signup_cap_status_get","tag/User-Management/operation/update_user_budget_user__user_id__budget_post","tag/User-Management/operation/block_user_user__user_id__block_post","tag/User-Management/operation/unblock_user_user__user_id__unblock_post","tag/User","tag/User/operation/user_info_user__user_id__get"],"index":{"version":"2.3.9","fields":["title","description"],"fieldVectors":[["title/0",[0,2.929]],["description/0",[0,3.354,1,4.086,2,1.601]],["title/1",[3,2.829,4,2.322]],["description/1",[5,4.552]],["title/2",[4,2.322,6,2.829]],["description/2",[7,4.552]],["title/3",[8,2.194]],["description/3",[2,1.601,8,2.512,9,4.086]],["title/4",[8,2.194]],["description/4",[8,2.799]],["title/5",[10,1.375,11,1.109]],["description/5",[10,0.957,11,1.422,12,1.384,13,1.616,14,1.968,15,1.968,16,1.384,17,1.968,18,1.21,19,1.968,20,1.384,21,1.384,22,1.21,23,1.968,24,1.616,25,1.072,26,1.616,27,1.968,28,1.968,29,1.384,30,1.616,31,1.384]],["title/6",[11,1.109,18,1.739]],["description/6",[10,1.156,11,1.591,12,1.673,16,1.673,18,2.122,20,1.673,21,1.673,25,1.296,26,1.953,32,2.38,33,2.38,34,2.38,35,1.953,36,1.953]],["title/7",[11,1.109,37,1.989]],["description/7",[10,1.123,11,1.324,13,1.897,16,1.624,18,1.421,21,1.624,22,1.421,24,1.897,25,1.258,38,2.311,39,1.624,40,1.624,41,2.311,42,1.897,43,2.311,44,2.311,45,2.311]],["title/8",[46,1.54,47,1.54]],["description/8",[2,1.453,37,2.605,42,3.042,46,2.018,47,2.018]],["title/9",[37,1.648,46,1.276,47,1.276]],["description/9",[48,4.552]],["title/10",[49,1.943]],["description/10",[2,1.601,49,2.225,50,4.086]],["title/11",[51,1.739,52,1.989]],["description/11",[10,0.909,11,0.733,12,0.547,22,0.478,25,0.424,29,0.547,30,0.639,31,0.547,36,0.639,39,1.315,40,0.547,46,1.019,47,1.019,51,0.478,53,1.535,54,1.385,55,0.639,56,2.736,57,2.135,58,1.595,59,0.639,60,0.639,61,0.639,62,1.385,63,1.385,64,1.385,65,0.778,66,1.385,67,0.639,68,0.778,69,0.778,70,0.778,71,0.778,72,0.778,73,0.424,74,0.547,75,0.778,76,0.778,77,0.778,78,0.778,79,0.778,80,0.639,81,0.778,82,0.639,83,0.478,84,0.478,85,0.778,86,0.778,87,0.778,88,1.385,89,1.385,90,0.778,91,0.778]],["title/12",[92,2.929]],["description/12",[10,0.542,11,0.437,22,0.686,25,0.607,29,0.784,31,1.331,39,1.735,40,0.784,46,0.607,47,0.607,49,0.607,53,1.555,56,2.389,57,2.026,58,2.046,59,0.916,60,0.916,61,0.916,73,0.607,74,0.784,80,0.916,82,0.916,92,2.026,93,1.115,94,1.115,95,1.115,96,1.115,97,1.115,98,1.115,99,1.115,100,1.894,101,1.115,102,1.115,103,1.115,104,1.115,105,1.115,106,1.115,107,1.115,108,1.115,109,1.115]],["title/13",[110,2.194]],["description/13",[2,1.523,74,2.732,110,2.39,111,3.887]],["title/14",[51,1.739,52,1.989]],["description/14",[2,1.388,49,1.929,110,2.178,112,2.907,113,2.907,114,3.542]],["title/15",[51,1.441,52,1.648,115,2.344]],["description/15",[2,1.136,20,2.037,35,2.379,49,1.578,58,2.037,110,1.782,112,2.379,113,2.379,116,2.898,117,2.898,118,2.898]],["title/16",[119,0.65,120,1.989]],["description/16",[2,1.388,73,1.929,119,0.814,120,2.49,121,2.49,122,2.907]],["title/17",[119,0.65,123,2.322]],["description/17",[119,1.071,123,3.042,124,3.706,125,3.706]],["title/18",[83,1.23,84,1.23,119,0.46,126,1.642]],["description/18",[119,0.747,126,2.67,127,3.253,128,3.253,129,3.253,130,2.67,131,3.253,132,3.253]],["title/19",[122,1.924,133,1.924,134,1.924]],["description/19",[83,2,84,2,120,2.287,130,2.67,133,2.67,134,2.67,135,3.253,136,3.253]],["title/20",[73,1.276,119,0.539,137,1.924]],["description/20",[55,2.379,67,2.379,73,1.578,83,1.782,84,1.782,137,2.379,138,2.898,139,2.898,140,2.898,141,2.898,142,2.898]],["title/21",[119,0.65,121,1.989]],["description/21",[119,0.893,121,2.732,143,3.191,144,3.887]],["title/22",[119,0.65,145,2.322]],["description/22",[119,0.893,143,3.191,145,3.191,146,3.887]],["title/23",[119,0.82]],["description/23",[]],["title/24",[119,0.65,147,2.829]],["description/24",[148,4.552]]],"invertedIndex":[["",{"_index":56,"title":{},"description":{"11":{},"12":{}}}],["1",{"_index":15,"title":{},"description":{"5":{}}}],["1-10",{"_index":108,"title":{},"description":{"12":{}}}],["2",{"_index":19,"title":{},"description":{"5":{}}}],["401",{"_index":86,"title":{},"description":{"11":{}}}],["ai",{"_index":63,"title":{},"description":{"11":{}}}],["ai-dev",{"_index":67,"title":{},"description":{"11":{},"20":{}}}],["ai-dev/memories-dev/mochi-dev",{"_index":81,"title":{},"description":{"11":{}}}],["ai/ai-dev/mochi-dev/memories/memories-dev",{"_index":75,"title":{},"description":{"11":{}}}],["android",{"_index":91,"title":{},"description":{"11":{}}}],["answer",{"_index":70,"title":{},"description":{"11":{}}}],["app",{"_index":10,"title":{"5":{}},"description":{"5":{},"6":{},"7":{},"11":{},"12":{}}}],["attest",{"_index":11,"title":{"5":{},"6":{},"7":{}},"description":{"5":{},"6":{},"7":{},"11":{},"12":{}}}],["attestationauth",{"_index":44,"title":{},"description":{"7":{}}}],["auth",{"_index":115,"title":{"15":{}},"description":{}}],["author",{"_index":39,"title":{},"description":{"7":{},"11":{},"12":{}}}],["bearer",{"_index":40,"title":{},"description":{"7":{},"11":{},"12":{}}}],["block",{"_index":121,"title":{"21":{}},"description":{"16":{},"21":{}}}],["bodi",{"_index":103,"title":{},"description":{"12":{}}}],["budget",{"_index":73,"title":{"20":{}},"description":{"11":{},"12":{},"16":{},"20":{}}}],["call",{"_index":35,"title":{},"description":{"6":{},"15":{}}}],["cap",{"_index":134,"title":{"19":{}},"description":{"19":{}}}],["capac",{"_index":135,"title":{},"description":{"19":{}}}],["challeng",{"_index":18,"title":{"6":{}},"description":{"5":{},"6":{},"7":{}}}],["chat",{"_index":51,"title":{"11":{},"14":{},"15":{}},"description":{"11":{}}}],["check",{"_index":1,"title":{},"description":{"0":{}}}],["client",{"_index":33,"title":{},"description":{"6":{}}}],["complet",{"_index":52,"title":{"11":{},"14":{},"15":{}},"description":{}}],["contain",{"_index":23,"title":{},"description":{"5":{}}}],["convo-starters-sidebar",{"_index":77,"title":{},"description":{"11":{}}}],["count",{"_index":126,"title":{"18":{}},"description":{"18":{}}}],["creat",{"_index":34,"title":{},"description":{"6":{}}}],["default",{"_index":99,"title":{},"description":{"12":{}}}],["dev",{"_index":54,"title":{},"description":{"11":{}}}],["e.g",{"_index":139,"title":{},"description":{"20":{}}}],["endpoint",{"_index":2,"title":{},"description":{"0":{},"3":{},"8":{},"10":{},"13":{},"14":{},"15":{},"16":{}}}],["exa",{"_index":95,"title":{},"description":{"12":{}}}],["experi",{"_index":101,"title":{},"description":{"12":{}}}],["experiment",{"_index":82,"title":{},"description":{"11":{},"12":{}}}],["first",{"_index":36,"title":{},"description":{"6":{},"11":{}}}],["flow",{"_index":14,"title":{},"description":{"5":{}}}],["fxa",{"_index":53,"title":{},"description":{"11":{},"12":{}}}],["gener",{"_index":32,"title":{},"description":{"6":{}}}],["group",{"_index":128,"title":{},"description":{"18":{}}}],["header",{"_index":31,"title":{},"description":{"5":{},"11":{},"12":{}}}],["health",{"_index":0,"title":{"0":{}},"description":{"0":{}}}],["health/liv",{"_index":5,"title":{},"description":{"1":{}}}],["health/readi",{"_index":7,"title":{},"description":{"2":{}}}],["higher",{"_index":140,"title":{},"description":{"20":{}}}],["info",{"_index":147,"title":{"24":{}},"description":{}}],["int",{"_index":107,"title":{},"description":{"12":{}}}],["integr",{"_index":47,"title":{"8":{},"9":{}},"description":{"8":{},"11":{},"12":{}}}],["interact",{"_index":50,"title":{},"description":{"10":{}}}],["io",{"_index":12,"title":{},"description":{"5":{},"6":{},"11":{}}}],["jwt",{"_index":22,"title":{},"description":{"5":{},"7":{},"11":{},"12":{}}}],["jwt-onli",{"_index":116,"title":{},"description":{"15":{}}}],["key",{"_index":26,"title":{},"description":{"5":{},"6":{}}}],["latenc",{"_index":113,"title":{},"description":{"14":{},"15":{}}}],["limit",{"_index":141,"title":{},"description":{"20":{}}}],["list",{"_index":123,"title":{"17":{}},"description":{"17":{}}}],["litellm",{"_index":49,"title":{"10":{}},"description":{"10":{},"12":{},"14":{},"15":{}}}],["live",{"_index":3,"title":{"1":{}},"description":{}}],["manag",{"_index":120,"title":{"16":{}},"description":{"16":{},"19":{}}}],["master_key",{"_index":131,"title":{},"description":{"18":{}}}],["match",{"_index":43,"title":{},"description":{"7":{}}}],["max_result",{"_index":106,"title":{},"description":{"12":{}}}],["memori",{"_index":66,"title":{},"description":{"11":{}}}],["memories-dev",{"_index":68,"title":{},"description":{"11":{}}}],["memory-gener",{"_index":78,"title":{},"description":{"11":{}}}],["metric",{"_index":8,"title":{"3":{},"4":{}},"description":{"3":{},"4":{}}}],["mlpa",{"_index":60,"title":{},"description":{"11":{},"12":{}}}],["mlpa_ui_access_key",{"_index":130,"title":{},"description":{"18":{},"19":{}}}],["mochi-dev",{"_index":69,"title":{},"description":{"11":{}}}],["mock",{"_index":110,"title":{"13":{}},"description":{"13":{},"14":{},"15":{}}}],["mock/chat/complet",{"_index":114,"title":{},"description":{"14":{}}}],["mock/chat/completions_no_auth",{"_index":118,"title":{},"description":{"15":{}}}],["oauth",{"_index":59,"title":{},"description":{"11":{},"12":{}}}],["object",{"_index":24,"title":{},"description":{"5":{},"7":{}}}],["obtain",{"_index":17,"title":{},"description":{"5":{}}}],["omit",{"_index":79,"title":{},"description":{"11":{}}}],["on",{"_index":62,"title":{},"description":{"11":{}}}],["pagin",{"_index":124,"title":{},"description":{"17":{}}}],["payload",{"_index":42,"title":{},"description":{"7":{},"8":{}}}],["play",{"_index":46,"title":{"8":{},"9":{}},"description":{"8":{},"11":{},"12":{}}}],["pool",{"_index":102,"title":{},"description":{"12":{}}}],["post",{"_index":20,"title":{},"description":{"5":{},"6":{},"15":{}}}],["probe",{"_index":4,"title":{"1":{},"2":{}},"description":{}}],["prometheu",{"_index":9,"title":{},"description":{"3":{}}}],["proxi",{"_index":94,"title":{},"description":{"12":{}}}],["purpos",{"_index":74,"title":{},"description":{"11":{},"12":{},"13":{}}}],["queri",{"_index":104,"title":{},"description":{"12":{}}}],["readi",{"_index":6,"title":{"2":{}},"description":{}}],["request",{"_index":28,"title":{},"description":{"5":{}}}],["requir",{"_index":57,"title":{},"description":{"11":{},"12":{}}}],["return",{"_index":85,"title":{},"description":{"11":{}}}],["s2",{"_index":64,"title":{},"description":{"11":{}}}],["s2s-android",{"_index":65,"title":{},"description":{"11":{}}}],["same",{"_index":97,"title":{},"description":{"12":{}}}],["schema",{"_index":45,"title":{},"description":{"7":{}}}],["search",{"_index":92,"title":{"12":{}},"description":{"12":{}}}],["search-dev",{"_index":100,"title":{},"description":{"12":{}}}],["servic",{"_index":83,"title":{"18":{}},"description":{"11":{},"19":{},"20":{}}}],["service-typ",{"_index":61,"title":{},"description":{"11":{},"12":{}}}],["service_typ",{"_index":129,"title":{},"description":{"18":{}}}],["set",{"_index":88,"title":{},"description":{"11":{}}}],["signup",{"_index":133,"title":{"19":{}},"description":{"19":{}}}],["simul",{"_index":112,"title":{},"description":{"14":{},"15":{}}}],["statu",{"_index":122,"title":{"19":{}},"description":{"16":{}}}],["str",{"_index":105,"title":{},"description":{"12":{}}}],["submit",{"_index":38,"title":{},"description":{"7":{}}}],["subsequ",{"_index":27,"title":{},"description":{"5":{}}}],["support",{"_index":125,"title":{},"description":{"17":{}}}],["telemetri",{"_index":71,"title":{},"description":{"11":{}}}],["test",{"_index":111,"title":{},"description":{"13":{}}}],["tier",{"_index":55,"title":{},"description":{"11":{},"20":{}}}],["title-gener",{"_index":76,"title":{},"description":{"11":{}}}],["token",{"_index":58,"title":{},"description":{"11":{},"12":{},"15":{}}}],["total",{"_index":127,"title":{},"description":{"18":{}}}],["track",{"_index":72,"title":{},"description":{"11":{}}}],["true",{"_index":89,"title":{},"description":{"11":{}}}],["type",{"_index":84,"title":{"18":{}},"description":{"11":{},"19":{},"20":{}}}],["unblock",{"_index":145,"title":{"22":{}},"description":{"22":{}}}],["updat",{"_index":137,"title":{"20":{}},"description":{"20":{}}}],["us",{"_index":25,"title":{},"description":{"5":{},"6":{},"7":{},"11":{},"12":{}}}],["use-app-attest",{"_index":30,"title":{},"description":{"5":{},"11":{}}}],["use-play-integr",{"_index":90,"title":{},"description":{"11":{}}}],["user",{"_index":119,"title":{"16":{},"17":{},"18":{},"20":{},"21":{},"22":{},"23":{},"24":{}},"description":{"16":{},"17":{},"18":{},"21":{},"22":{}}}],["user'",{"_index":138,"title":{},"description":{"20":{}}}],["user/counts-by-service-typ",{"_index":132,"title":{},"description":{"18":{}}}],["user/signup-cap-statu",{"_index":136,"title":{},"description":{"19":{}}}],["user/{user_id",{"_index":148,"title":{},"description":{"24":{}}}],["user/{user_id}/block",{"_index":144,"title":{},"description":{"21":{}}}],["user/{user_id}/budget",{"_index":142,"title":{},"description":{"20":{}}}],["user/{user_id}/unblock",{"_index":146,"title":{},"description":{"22":{}}}],["user_id",{"_index":143,"title":{},"description":{"21":{},"22":{}}}],["v1/chat/complet",{"_index":29,"title":{},"description":{"5":{},"11":{},"12":{}}}],["v1/search",{"_index":109,"title":{},"description":{"12":{}}}],["valid",{"_index":117,"title":{},"description":{"15":{}}}],["verif",{"_index":13,"title":{},"description":{"5":{},"7":{}}}],["verifi",{"_index":37,"title":{"7":{},"9":{}},"description":{"8":{}}}],["verify/attest",{"_index":21,"title":{},"description":{"5":{},"6":{},"7":{}}}],["verify/challeng",{"_index":16,"title":{},"description":{"5":{},"6":{},"7":{}}}],["verify/play",{"_index":48,"title":{},"description":{"9":{}}}],["via",{"_index":96,"title":{},"description":{"12":{}}}],["way",{"_index":98,"title":{},"description":{"12":{}}}],["web",{"_index":93,"title":{},"description":{"12":{}}}],["whose",{"_index":41,"title":{},"description":{"7":{}}}],["without",{"_index":87,"title":{},"description":{"11":{}}}],["x-dev-author",{"_index":80,"title":{},"description":{"11":{},"12":{}}}]],"pipeline":[]}},"options":{}};
+      const __redoc_state = {"menu":{"activeItemIdx":-1},"spec":{"data":{"openapi":"3.1.0","info":{"title":"MLPA","description":"Authenticates and proxies LLM requests through LiteLLM to enact budgets and per-user management.","version":"1.0.23"},"paths":{"/metrics":{"get":{"tags":["Metrics"],"summary":"Get Metrics","operationId":"get_metrics_metrics_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/health/liveness":{"get":{"tags":["Health"],"summary":"Liveness Probe","operationId":"liveness_probe_health_liveness_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/health/readiness":{"get":{"tags":["Health"],"summary":"Readiness Probe","operationId":"readiness_probe_health_readiness_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/verify/challenge":{"get":{"tags":["App Attest"],"summary":"Get attestation challenge","description":"Generate a challenge for iOS App Attest. The client uses this challenge when creating an attestation key. Call this first, then POST the attestation to /verify/attest.","operationId":"get_challenge_verify_challenge_get","parameters":[{"name":"key_id_b64","in":"query","required":true,"schema":{"type":"string","description":"Base64-encoded attestation key ID from the iOS device","title":"Key Id B64"},"description":"Base64-encoded attestation key ID from the iOS device"}],"responses":{"200":{"description":"Challenge generated successfully","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ChallengeResponse"}}}},"400":{"description":"Bad Request - Missing or invalid key_id_b64"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/verify/attest":{"post":{"tags":["App Attest"],"summary":"Verify attestation","description":"Submit the App Attest attestation object for verification. Authorization must be a Bearer JWT whose payload matches the AttestationAuth schema. Use the challenge from GET /verify/challenge.","operationId":"attest_verify_attest_post","parameters":[{"name":"authorization","in":"header","required":true,"schema":{"type":"string","description":"Bearer JWT with payload matching AttestationAuth schema","title":"Authorization"},"description":"Bearer JWT with payload matching AttestationAuth schema"},{"name":"use-qa-certificates","in":"header","required":false,"schema":{"anyOf":[{"type":"boolean"},{"type":"null"}],"description":"Use QA certificates (set to true for development/sandbox testing)","title":"Use-Qa-Certificates"},"description":"Use QA certificates (set to true for development/sandbox testing)"}],"responses":{"201":{"description":"Attestation verified successfully","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AttestSuccessResponse"}}}},"400":{"description":"Bad Request - Invalid base64 in JWT payload"},"401":{"description":"Unauthorized - Invalid or expired challenge, or invalid attestation"},"403":{"description":"Forbidden - Attestation verification failed"},"422":{"description":"Unprocessable Entity - Missing required Authorization header"}}}},"/verify/play":{"post":{"tags":["Play Integrity"],"summary":"Verify Play Integrity","operationId":"verify_play_integrity_verify_play_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlayIntegrityRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlayIntegrityTokenResponse"}}}},"401":{"description":"Unauthorized - the Play Integrity check did not pass. The token, package name, request hash, or the app/device verdicts failed verification. `detail` is a string for verdict failures, or an object like `{\"error\": ...}` when the upstream Play Integrity API rejects the token.","content":{"application/json":{"schema":{"properties":{"detail":{"anyOf":[{"type":"string"},{"properties":{"error":{"type":"string"}},"type":"object"}]}},"type":"object","required":["detail"]},"examples":{"verdict_failed":{"summary":"Verdict failed (string detail)","value":{"detail":"Invalid Play Integrity token"}},"upstream_rejected":{"summary":"Upstream Play API rejected the token (object detail)","value":{"detail":{"error":"Upstream service returned an error"}}}}}}},"403":{"description":"Forbidden - the requested package name is not allowed.","content":{"application/json":{"schema":{"properties":{"detail":{"type":"string"}},"type":"object","required":["detail"]},"example":{"detail":"Package name not allowed"}}}},"422":{"description":"Validation Error - the request body did not match the schema, for example a missing or wrong-typed field. FastAPI returns this before the handler runs, so it is not an auth failure (those return 401).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"502":{"description":"Bad Gateway - the Play Integrity validation service is unavailable.","content":{"application/json":{"schema":{"properties":{"detail":{"properties":{"error":{"type":"string"}},"type":"object"}},"type":"object","required":["detail"]},"example":{"detail":{"error":"Play Integrity validation service unavailable"}}}}}}}},"/user":{"get":{"tags":["User Management"],"summary":"List Users","description":"List all users with pagination support.","operationId":"list_users_user_get","parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":200,"minimum":1,"default":50,"title":"Limit"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"default":0,"title":"Offset"}},{"name":"master-key","in":"header","required":true,"schema":{"type":"string","title":"Master Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"401":{"description":"Unauthorized - the master_key or mlpa_ui_access_key header is missing or wrong.","content":{"application/json":{"schema":{"type":"object","properties":{"detail":{"type":"object","properties":{"error":{"type":"string"}}}},"required":["detail"]},"example":{"detail":{"error":"Unauthorized"}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/user/counts-by-service-type":{"get":{"tags":["User Management"],"summary":"Count Users By Service Type","description":"Get total user counts grouped by service_type (MLPA_UI_ACCESS_KEY, not MASTER_KEY).","operationId":"count_users_by_service_type_user_counts_by_service_type_get","parameters":[{"name":"mlpa-ui-access-key","in":"header","required":true,"schema":{"type":"string","title":"Mlpa Ui Access Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"401":{"description":"Unauthorized - the master_key or mlpa_ui_access_key header is missing or wrong.","content":{"application/json":{"schema":{"type":"object","properties":{"detail":{"type":"object","properties":{"error":{"type":"string"}}}},"required":["detail"]},"example":{"detail":{"error":"Unauthorized"}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/user/signup-cap-status":{"get":{"tags":["User Management"],"summary":"Signup Cap Status","description":"Managed signup capacity for capped service types (MLPA_UI_ACCESS_KEY).","operationId":"signup_cap_status_user_signup_cap_status_get","parameters":[{"name":"mlpa-ui-access-key","in":"header","required":true,"schema":{"type":"string","title":"Mlpa Ui Access Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"401":{"description":"Unauthorized - the master_key or mlpa_ui_access_key header is missing or wrong.","content":{"application/json":{"schema":{"type":"object","properties":{"detail":{"type":"object","properties":{"error":{"type":"string"}}}},"required":["detail"]},"example":{"detail":{"error":"Unauthorized"}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/user/{user_id}":{"get":{"tags":["User"],"summary":"User Info","operationId":"user_info_user__user_id__get","parameters":[{"name":"user_id","in":"path","required":true,"schema":{"type":"string","title":"User Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"404":{"description":"User not found.","content":{"application/json":{"schema":{"type":"object","properties":{"detail":{"type":"string"}},"required":["detail"]},"example":{"detail":"User not found"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/user/{user_id}/budget":{"post":{"tags":["User Management"],"summary":"Update User Budget","description":"Update a user's budget tier by service type (e.g. ai-dev for higher limits).","operationId":"update_user_budget_user__user_id__budget_post","parameters":[{"name":"user_id","in":"path","required":true,"schema":{"type":"string","title":"User Id"}},{"name":"master-key","in":"header","required":true,"schema":{"type":"string","title":"Master Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BudgetUpdatePayload"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"401":{"description":"Unauthorized - the master_key or mlpa_ui_access_key header is missing or wrong.","content":{"application/json":{"schema":{"type":"object","properties":{"detail":{"type":"object","properties":{"error":{"type":"string"}}}},"required":["detail"]},"example":{"detail":{"error":"Unauthorized"}}}}},"404":{"description":"User not found.","content":{"application/json":{"schema":{"type":"object","properties":{"detail":{"type":"string"}},"required":["detail"]},"example":{"detail":"User not found"}}}},"422":{"description":"Unprocessable Entity. Two things return this status: an unknown service type in the payload, where `detail` is an object like `{\"error\": ...}`, and FastAPI body validation, where `detail` is a list like `[{\"loc\", \"msg\", ...}]`.","content":{"application/json":{"schema":{"type":"object","properties":{"detail":{"anyOf":[{"type":"object","properties":{"error":{"type":"string"}}},{"type":"array","items":{"type":"object"}}]}},"required":["detail"]},"examples":{"unknown_service_type":{"summary":"Unknown service type (object detail)","value":{"detail":{"error":"Unknown service type: foo. Valid values: ai, ai-dev, ..."}}},"request_validation":{"summary":"Request body validation (list detail)","value":{"detail":[{"loc":["body","service_type"],"msg":"Field required","type":"missing"}]}}}}}}}}},"/user/{user_id}/block":{"post":{"tags":["User Management"],"summary":"Block User","description":"Block a user by their user_id.","operationId":"block_user_user__user_id__block_post","parameters":[{"name":"user_id","in":"path","required":true,"schema":{"type":"string","title":"User Id"}},{"name":"master-key","in":"header","required":true,"schema":{"type":"string","title":"Master Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"401":{"description":"Unauthorized - the master_key or mlpa_ui_access_key header is missing or wrong.","content":{"application/json":{"schema":{"type":"object","properties":{"detail":{"type":"object","properties":{"error":{"type":"string"}}}},"required":["detail"]},"example":{"detail":{"error":"Unauthorized"}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/user/{user_id}/unblock":{"post":{"tags":["User Management"],"summary":"Unblock User","description":"Unblock a user by their user_id.","operationId":"unblock_user_user__user_id__unblock_post","parameters":[{"name":"user_id","in":"path","required":true,"schema":{"type":"string","title":"User Id"}},{"name":"master-key","in":"header","required":true,"schema":{"type":"string","title":"Master Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"401":{"description":"Unauthorized - the master_key or mlpa_ui_access_key header is missing or wrong.","content":{"application/json":{"schema":{"type":"object","properties":{"detail":{"type":"object","properties":{"error":{"type":"string"}}}},"required":["detail"]},"example":{"detail":{"error":"Unauthorized"}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/mock/chat/completions":{"post":{"tags":["Mock"],"summary":"Chat Completion","description":"Mock LiteLLM endpoint with simulated latency.","operationId":"chat_completion_mock_chat_completions_post","parameters":[{"name":"authorization","in":"header","required":true,"schema":{"type":"string","title":"Authorization"}},{"name":"service-type","in":"header","required":true,"schema":{"$ref":"#/components/schemas/ServiceType"}},{"name":"purpose","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Purpose"}},{"name":"x-dev-authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Dev-Authorization"}},{"name":"use-app-attest","in":"header","required":false,"schema":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Use-App-Attest"}},{"name":"use-qa-certificates","in":"header","required":false,"schema":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Use-Qa-Certificates"}},{"name":"use-play-integrity","in":"header","required":false,"schema":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Use-Play-Integrity"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ChatRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/mock/chat/completions_no_auth":{"post":{"tags":["Mock"],"summary":"Chat Completion No Auth","description":"Mock LiteLLM endpoint with simulated latency and JWT-only token validation (no POST calls).","operationId":"chat_completion_no_auth_mock_chat_completions_no_auth_post","parameters":[{"name":"authorization","in":"header","required":true,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ChatRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/chat/completions":{"post":{"tags":["LiteLLM"],"summary":"Chat Completion","description":"Authorize first using App Attest, Play Integrity, FxA, or dev tier.\n\n**Headers:**\n\n- **Authorization** (required): Bearer token — FxA OAuth token, Play Integrity MLPA token, or App Attest JWT.\n- **service-type** (required): One of `ai`, `s2s`, `s2s-android`, `memories`, `ai-dev`, `memories-dev`, `mochi-dev`, `answer`, `telemetry` — for tracking and budget.\n- **purpose** (required for ai/ai-dev/mochi-dev/memories/memories-dev): One of `chat`, `title-generation`, `convo-starters-sidebar` for AI; `memory-generation` for memories; omit for s2s.\n- **x-dev-authorization** (required for ai-dev/memories-dev/mochi-dev): Experimentation token; also requires FxA in Authorization. Dev service types return 401 without it.\n- **use-app-attest**: Set to `true` for iOS App Attest.\n- **use-play-integrity**: Set to `true` for Android Play Integrity.","operationId":"chat_completion_v1_chat_completions_post","parameters":[{"name":"authorization","in":"header","required":true,"schema":{"type":"string","title":"Authorization"},"description":"Bearer token: FxA OAuth, Play Integrity MLPA token, or App Attest JWT."},{"name":"service-type","in":"header","required":true,"schema":{"type":"string","enum":["ai","s2s","s2s-android","memories","answer","telemetry","agent","ai-dev","memories-dev","mochi-dev"],"title":"Service-Type"},"description":"Service type for tracking and budget. Use ai-dev, memories-dev, or mochi-dev for experiments (higher limits)."},{"name":"purpose","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Purpose"},"description":"Purpose for Prometheus and product tracking. Optional (validated if provided). AI: chat, title-generation, convo-starters-sidebar. Memories: memory-generation. Omit or leave empty for s2s, s2s-android."},{"name":"x-dev-authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Dev-Authorization"},"description":"Required for ai-dev/memories-dev/mochi-dev. Experimentation token; also requires Authorization (FxA). Without it, dev service types return 401."},{"name":"use-app-attest","in":"header","required":false,"schema":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Use-App-Attest"},"description":"Optional. Set to true for iOS App Attest; Authorization must contain AssertionAuth JWT."},{"name":"use-qa-certificates","in":"header","required":false,"schema":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Use-Qa-Certificates"},"description":"Optional. For App Attest QA/sandbox testing."},{"name":"use-play-integrity","in":"header","required":false,"schema":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Use-Play-Integrity"},"description":"Optional. Set to true for Android Play Integrity; Authorization contains MLPA token from /verify/play."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ChatRequest"}}}},"responses":{"200":{"description":"OpenAI-compatible chat completion. Returns a JSON completion object, or a `text/event-stream` of SSE chunks when `stream` is `true`.","content":{"application/json":{"schema":{}},"text/event-stream":{}}},"400":{"description":"Bad Request - Invalid model name or malformed request body","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"integer","description":"Error code: 8 invalid model name, 9 invalid request body"}},"required":["error"]},"examples":{"invalid_model_name":{"summary":"Invalid model name","value":{"error":8},"description":"Requested model is not configured in LiteLLM."},"invalid_request":{"summary":"Invalid request body","value":{"error":9},"description":"Upstream rejected the request as malformed (e.g. invalid JSON body)."}}}}},"401":{"description":"Unauthorized - authentication failed or was missing. Either the Authorization header is absent, the FxA / App Attest / Play Integrity credentials did not verify, or the x-dev-authorization token is wrong for a dev service type.","content":{"application/json":{"schema":{"type":"object","properties":{"detail":{"type":"string","description":"Human-readable reason the request was not authorized."}},"required":["detail"]},"examples":{"missing_authorization_header":{"summary":"Missing authorization header","value":{"detail":"Missing authorization header"}},"invalid_fxa_auth":{"summary":"Invalid FxA auth","value":{"detail":"Invalid FxA auth"}},"invalid_dev_authorization":{"summary":"Invalid dev authorization","value":{"detail":"Invalid x-dev-authorization"}}}}}},"403":{"description":"Forbidden - Maximum signed-in users reached","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"integer","description":"Error code: 4 for maximum signed-in users reached"}},"required":["error"]},"examples":{"max_users_reached":{"summary":"Maximum signed-in users reached","value":{"error":4},"description":"New sign-ins for cap-managed service types are rejected because capacity is full."}}}}},"413":{"description":"Payload Too Large - Request body or context exceeded","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"integer","description":"Error code: 3 for request/context too large"}},"required":["error"]},"example":{"error":3}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"429":{"description":"Too Many Requests — budget or rate limit exceeded from MLPA/LiteLLM, or HTTP 429 from the Fastly WAF in front of MLPA (body `error`: 6).","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"integer","description":"Error code: 1 budget limit exceeded, 2 rate limit (TPM/RPM), 5 upstream provider rate limit, 6 Fastly WAF rate limit (edge; not from MLPA)"}},"required":["error"]},"examples":{"budget_exceeded":{"summary":"Budget limit exceeded","value":{"error":1},"description":"Budget limit exceeded. Check Retry-After header (86400 seconds = 1 day)."},"rate_limit_exceeded":{"summary":"Rate limit exceeded","value":{"error":2},"description":"Rate limit exceeded (TPM/RPM). Check Retry-After header (60 seconds)."},"upstream_rate_limit_exceeded":{"summary":"Upstream rate limit exceeded","value":{"error":5},"description":"Upstream provider rate limit exceeded."},"fastly_waf_rate_limit":{"summary":"Fastly WAF rate limit","value":{"error":6},"description":"HTTP 429 returned at the Fastly edge (WAF) before the request reaches MLPA. "}}}},"headers":{"Retry-After":{"description":"Number of seconds to wait before retrying","schema":{"type":"string","example":"86400"}}}}}}},"/v1/search":{"post":{"tags":["LiteLLM"],"summary":"Search","description":"Web search proxied to Exa via LiteLLM. Authorize the same way as /v1/chat/completions.\n\n**Headers:**\n\n- **Authorization** (required): Bearer token — FxA OAuth token, Play Integrity MLPA token, or App Attest JWT.\n- **service-type**: `search` by default; use `search-dev` for experiments. Search has its own budget pool and no `purpose` header.\n- **x-dev-authorization** (required for search-dev): Experimentation token; also requires FxA in Authorization.\n\n**Body:** `{\"query\": str, \"max_results\": int (1-10)}`.","operationId":"search_v1_search_post","parameters":[{"name":"authorization","in":"header","required":true,"schema":{"type":"string","title":"Authorization"}},{"name":"service-type","in":"header","required":false,"schema":{"type":"string","enum":["search","search-dev"],"default":"search","title":"Service-Type"},"description":"Service type for search requests. Use search-dev for experiments; it requires x-dev-authorization."},{"name":"purpose","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Purpose"}},{"name":"x-dev-authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Dev-Authorization"},"description":"Required when service-type is search-dev. Experimentation token; also requires Authorization (FxA)."},{"name":"use-app-attest","in":"header","required":false,"schema":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Use-App-Attest"}},{"name":"use-qa-certificates","in":"header","required":false,"schema":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Use-Qa-Certificates"}},{"name":"use-play-integrity","in":"header","required":false,"schema":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Use-Play-Integrity"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SearchRequest"}}}},"responses":{"200":{"description":"Search results returned from the Exa search backend.","content":{"application/json":{"schema":{}}}},"400":{"description":"Bad Request - Invalid model name or malformed request body","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"integer","description":"Error code: 8 invalid model name, 9 invalid request body"}},"required":["error"]},"examples":{"invalid_model_name":{"summary":"Invalid model name","value":{"error":8},"description":"Requested model is not configured in LiteLLM."},"invalid_request":{"summary":"Invalid request body","value":{"error":9},"description":"Upstream rejected the request as malformed (e.g. invalid JSON body)."}}}}},"401":{"description":"Unauthorized - authentication failed or was missing. Either the Authorization header is absent, the FxA / App Attest / Play Integrity credentials did not verify, or the x-dev-authorization token is wrong for a dev service type.","content":{"application/json":{"schema":{"type":"object","properties":{"detail":{"type":"string","description":"Human-readable reason the request was not authorized."}},"required":["detail"]},"examples":{"missing_authorization_header":{"summary":"Missing authorization header","value":{"detail":"Missing authorization header"}},"invalid_fxa_auth":{"summary":"Invalid FxA auth","value":{"detail":"Invalid FxA auth"}},"invalid_dev_authorization":{"summary":"Invalid dev authorization","value":{"detail":"Invalid x-dev-authorization"}}}}}},"403":{"description":"Forbidden - Maximum signed-in users reached","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"integer","description":"Error code: 4 for maximum signed-in users reached"}},"required":["error"]},"examples":{"max_users_reached":{"summary":"Maximum signed-in users reached","value":{"error":4},"description":"New sign-ins for cap-managed service types are rejected because capacity is full."}}}}},"413":{"description":"Payload Too Large - Request body or context exceeded","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"integer","description":"Error code: 3 for request/context too large"}},"required":["error"]},"example":{"error":3}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"429":{"description":"Too Many Requests — budget or rate limit exceeded from MLPA/LiteLLM, or HTTP 429 from the Fastly WAF in front of MLPA (body `error`: 6).","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"integer","description":"Error code: 1 budget limit exceeded, 2 rate limit (TPM/RPM), 5 upstream provider rate limit, 6 Fastly WAF rate limit (edge; not from MLPA)"}},"required":["error"]},"examples":{"budget_exceeded":{"summary":"Budget limit exceeded","value":{"error":1},"description":"Budget limit exceeded. Check Retry-After header (86400 seconds = 1 day)."},"rate_limit_exceeded":{"summary":"Rate limit exceeded","value":{"error":2},"description":"Rate limit exceeded (TPM/RPM). Check Retry-After header (60 seconds)."},"upstream_rate_limit_exceeded":{"summary":"Upstream rate limit exceeded","value":{"error":5},"description":"Upstream provider rate limit exceeded."},"fastly_waf_rate_limit":{"summary":"Fastly WAF rate limit","value":{"error":6},"description":"HTTP 429 returned at the Fastly edge (WAF) before the request reaches MLPA. "}}}},"headers":{"Retry-After":{"description":"Number of seconds to wait before retrying","schema":{"type":"string","example":"86400"}}}}}}}},"components":{"schemas":{"AttestSuccessResponse":{"properties":{"status":{"type":"string","title":"Status"}},"type":"object","required":["status"],"title":"AttestSuccessResponse"},"BudgetUpdatePayload":{"properties":{"service_type":{"type":"string","title":"Service Type"}},"type":"object","required":["service_type"],"title":"BudgetUpdatePayload","description":"Payload for updating a user's budget tier."},"ChallengeResponse":{"properties":{"challenge":{"type":"string","title":"Challenge"}},"type":"object","required":["challenge"],"title":"ChallengeResponse"},"ChatRequest":{"properties":{"model":{"type":"string","title":"Model"},"stream":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Stream","default":false},"messages":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Messages","default":[]},"temperature":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Temperature","default":0.1},"max_completion_tokens":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Max Completion Tokens","default":8192},"top_p":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Top P","default":0.01},"tools":{"anyOf":[{"items":{},"type":"array"},{"type":"null"}],"title":"Tools"},"tool_choice":{"anyOf":[{"type":"string"},{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Tool Choice"},"n":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"N"},"stream_options":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Stream Options"},"stop":{"anyOf":[{"type":"string"},{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Stop"},"max_tokens":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Max Tokens"},"presence_penalty":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Presence Penalty"},"frequency_penalty":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Frequency Penalty"},"logit_bias":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Logit Bias"},"response_format":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Response Format"},"seed":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Seed"},"parallel_tool_calls":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Parallel Tool Calls"},"logprobs":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Logprobs"},"top_logprobs":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Top Logprobs"},"text":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Text"}},"type":"object","required":["model"],"title":"ChatRequest"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"PlayIntegrityRequest":{"properties":{"integrity_token":{"type":"string","title":"Integrity Token"},"user_id":{"type":"string","title":"User Id"},"package_name":{"type":"string","title":"Package Name","default":"org.mozilla.firefox"}},"type":"object","required":["integrity_token","user_id"],"title":"PlayIntegrityRequest"},"PlayIntegrityTokenResponse":{"properties":{"access_token":{"type":"string","title":"Access Token"},"token_type":{"type":"string","title":"Token Type"},"expires_in":{"type":"integer","title":"Expires In"}},"type":"object","required":["access_token","token_type","expires_in"],"title":"PlayIntegrityTokenResponse","description":"Short-lived MLPA access token issued after Play Integrity verification."},"SearchRequest":{"properties":{"query":{"type":"string","title":"Query"},"max_results":{"type":"integer","maximum":10,"minimum":1,"title":"Max Results"}},"type":"object","required":["query","max_results"],"title":"SearchRequest"},"ServiceType":{"type":"string","enum":["ai","s2s","s2s-android","memories","search","answer","telemetry","agent","ai-dev","memories-dev","mochi-dev","search-dev"],"title":"ServiceType"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"},"input":{"title":"Input"},"ctx":{"type":"object","title":"Context"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"},"AttestationAuth":{"properties":{"key_id_b64":{"title":"Key Id B64","type":"string"},"challenge_b64":{"title":"Challenge B64","type":"string"},"attestation_obj_b64":{"title":"Attestation Obj B64","type":"string"},"bundle_id":{"title":"Bundle Id","type":"string"}},"required":["key_id_b64","challenge_b64","attestation_obj_b64","bundle_id"],"title":"AttestationAuth","type":"object","description":"JWT payload for POST /verify/attest"},"AssertionAuth":{"properties":{"key_id_b64":{"title":"Key Id B64","type":"string"},"challenge_b64":{"title":"Challenge B64","type":"string"},"assertion_obj_b64":{"title":"Assertion Obj B64","type":"string"},"bundle_id":{"title":"Bundle Id","type":"string"}},"required":["key_id_b64","challenge_b64","assertion_obj_b64","bundle_id"],"title":"AssertionAuth","type":"object","description":"JWT payload for POST /v1/chat/completions with use-app-attest"}}},"tags":[{"name":"Health","description":"Health check endpoints."},{"name":"Metrics","description":"Prometheus metrics endpoints."},{"name":"App Attest","description":"iOS App Attest verification flow: (1) GET /verify/challenge to obtain a challenge, (2) POST /verify/attest with a JWT containing the attestation object. Use the attested key for subsequent requests to /v1/chat/completions with use-app-attest header."},{"name":"Play Integrity","description":"Endpoints for verifying Play Integrity payloads."},{"name":"LiteLLM","description":"Endpoints for interacting with LiteLLM."},{"name":"Mock","description":"Mock endpoints for testing purposes."},{"name":"User Management","description":"Endpoints for managing user blocking status and budgets."}]}},"searchIndex":{"store":["tag/Health","tag/Health/operation/liveness_probe_health_liveness_get","tag/Health/operation/readiness_probe_health_readiness_get","tag/Metrics","tag/Metrics/operation/get_metrics_metrics_get","tag/App-Attest","tag/App-Attest/operation/get_challenge_verify_challenge_get","tag/App-Attest/operation/attest_verify_attest_post","tag/Play-Integrity","tag/Play-Integrity/operation/verify_play_integrity_verify_play_post","tag/LiteLLM","tag/LiteLLM/operation/chat_completion_v1_chat_completions_post","tag/LiteLLM/operation/search_v1_search_post","tag/Mock","tag/Mock/operation/chat_completion_mock_chat_completions_post","tag/Mock/operation/chat_completion_no_auth_mock_chat_completions_no_auth_post","tag/User-Management","tag/User-Management/operation/list_users_user_get","tag/User-Management/operation/count_users_by_service_type_user_counts_by_service_type_get","tag/User-Management/operation/signup_cap_status_user_signup_cap_status_get","tag/User-Management/operation/update_user_budget_user__user_id__budget_post","tag/User-Management/operation/block_user_user__user_id__block_post","tag/User-Management/operation/unblock_user_user__user_id__unblock_post","tag/User","tag/User/operation/user_info_user__user_id__get"],"index":{"version":"2.3.9","fields":["title","description"],"fieldVectors":[["title/0",[0,2.929]],["description/0",[0,3.354,1,4.086,2,1.601]],["title/1",[3,2.829,4,2.322]],["description/1",[5,4.552]],["title/2",[4,2.322,6,2.829]],["description/2",[7,4.552]],["title/3",[8,2.194]],["description/3",[2,1.601,8,2.512,9,4.086]],["title/4",[8,2.194]],["description/4",[8,2.799]],["title/5",[10,1.375,11,1.109]],["description/5",[10,0.957,11,1.422,12,1.384,13,1.616,14,1.968,15,1.968,16,1.384,17,1.968,18,1.21,19,1.968,20,1.384,21,1.384,22,1.21,23,1.968,24,1.616,25,1.072,26,1.616,27,1.968,28,1.968,29,1.384,30,1.616,31,1.384]],["title/6",[11,1.109,18,1.739]],["description/6",[10,1.156,11,1.591,12,1.673,16,1.673,18,2.122,20,1.673,21,1.673,25,1.296,26,1.953,32,2.38,33,2.38,34,2.38,35,1.953,36,1.953]],["title/7",[11,1.109,37,1.989]],["description/7",[10,1.123,11,1.324,13,1.897,16,1.624,18,1.421,21,1.624,22,1.421,24,1.897,25,1.258,38,2.311,39,1.624,40,1.624,41,2.311,42,1.897,43,2.311,44,2.311,45,2.311]],["title/8",[46,1.54,47,1.54]],["description/8",[2,1.453,37,2.605,42,3.042,46,2.018,47,2.018]],["title/9",[37,1.648,46,1.276,47,1.276]],["description/9",[48,4.552]],["title/10",[49,1.943]],["description/10",[2,1.601,49,2.225,50,4.086]],["title/11",[51,1.739,52,1.989]],["description/11",[10,0.909,11,0.733,12,0.547,22,0.478,25,0.424,29,0.547,30,0.639,31,0.547,36,0.639,39,1.315,40,0.547,46,1.019,47,1.019,51,0.478,53,1.535,54,1.385,55,0.639,56,2.736,57,2.135,58,1.595,59,0.639,60,0.639,61,0.639,62,1.385,63,1.385,64,1.385,65,0.778,66,1.385,67,0.639,68,0.778,69,0.778,70,0.778,71,0.778,72,0.778,73,0.424,74,0.547,75,0.778,76,0.778,77,0.778,78,0.778,79,0.778,80,0.639,81,0.778,82,0.639,83,0.478,84,0.478,85,0.778,86,0.778,87,0.778,88,1.385,89,1.385,90,0.778,91,0.778]],["title/12",[92,2.929]],["description/12",[10,0.542,11,0.437,22,0.686,25,0.607,29,0.784,31,1.331,39,1.735,40,0.784,46,0.607,47,0.607,49,0.607,53,1.555,56,2.389,57,2.026,58,2.046,59,0.916,60,0.916,61,0.916,73,0.607,74,0.784,80,0.916,82,0.916,92,2.026,93,1.115,94,1.115,95,1.115,96,1.115,97,1.115,98,1.115,99,1.115,100,1.894,101,1.115,102,1.115,103,1.115,104,1.115,105,1.115,106,1.115,107,1.115,108,1.115,109,1.115]],["title/13",[110,2.194]],["description/13",[2,1.523,74,2.732,110,2.39,111,3.887]],["title/14",[51,1.739,52,1.989]],["description/14",[2,1.388,49,1.929,110,2.178,112,2.907,113,2.907,114,3.542]],["title/15",[51,1.441,52,1.648,115,2.344]],["description/15",[2,1.136,20,2.037,35,2.379,49,1.578,58,2.037,110,1.782,112,2.379,113,2.379,116,2.898,117,2.898,118,2.898]],["title/16",[119,0.65,120,1.989]],["description/16",[2,1.388,73,1.929,119,0.814,120,2.49,121,2.49,122,2.907]],["title/17",[119,0.65,123,2.322]],["description/17",[119,1.071,123,3.042,124,3.706,125,3.706]],["title/18",[83,1.23,84,1.23,119,0.46,126,1.642]],["description/18",[119,0.747,126,2.67,127,3.253,128,3.253,129,3.253,130,2.67,131,3.253,132,3.253]],["title/19",[122,1.924,133,1.924,134,1.924]],["description/19",[83,2,84,2,120,2.287,130,2.67,133,2.67,134,2.67,135,3.253,136,3.253]],["title/20",[73,1.276,119,0.539,137,1.924]],["description/20",[55,2.379,67,2.379,73,1.578,83,1.782,84,1.782,137,2.379,138,2.898,139,2.898,140,2.898,141,2.898,142,2.898]],["title/21",[119,0.65,121,1.989]],["description/21",[119,0.893,121,2.732,143,3.191,144,3.887]],["title/22",[119,0.65,145,2.322]],["description/22",[119,0.893,143,3.191,145,3.191,146,3.887]],["title/23",[119,0.82]],["description/23",[]],["title/24",[119,0.65,147,2.829]],["description/24",[148,4.552]]],"invertedIndex":[["",{"_index":56,"title":{},"description":{"11":{},"12":{}}}],["1",{"_index":15,"title":{},"description":{"5":{}}}],["1-10",{"_index":108,"title":{},"description":{"12":{}}}],["2",{"_index":19,"title":{},"description":{"5":{}}}],["401",{"_index":86,"title":{},"description":{"11":{}}}],["ai",{"_index":63,"title":{},"description":{"11":{}}}],["ai-dev",{"_index":67,"title":{},"description":{"11":{},"20":{}}}],["ai-dev/memories-dev/mochi-dev",{"_index":81,"title":{},"description":{"11":{}}}],["ai/ai-dev/mochi-dev/memories/memories-dev",{"_index":75,"title":{},"description":{"11":{}}}],["android",{"_index":91,"title":{},"description":{"11":{}}}],["answer",{"_index":70,"title":{},"description":{"11":{}}}],["app",{"_index":10,"title":{"5":{}},"description":{"5":{},"6":{},"7":{},"11":{},"12":{}}}],["attest",{"_index":11,"title":{"5":{},"6":{},"7":{}},"description":{"5":{},"6":{},"7":{},"11":{},"12":{}}}],["attestationauth",{"_index":44,"title":{},"description":{"7":{}}}],["auth",{"_index":115,"title":{"15":{}},"description":{}}],["author",{"_index":39,"title":{},"description":{"7":{},"11":{},"12":{}}}],["bearer",{"_index":40,"title":{},"description":{"7":{},"11":{},"12":{}}}],["block",{"_index":121,"title":{"21":{}},"description":{"16":{},"21":{}}}],["bodi",{"_index":103,"title":{},"description":{"12":{}}}],["budget",{"_index":73,"title":{"20":{}},"description":{"11":{},"12":{},"16":{},"20":{}}}],["call",{"_index":35,"title":{},"description":{"6":{},"15":{}}}],["cap",{"_index":134,"title":{"19":{}},"description":{"19":{}}}],["capac",{"_index":135,"title":{},"description":{"19":{}}}],["challeng",{"_index":18,"title":{"6":{}},"description":{"5":{},"6":{},"7":{}}}],["chat",{"_index":51,"title":{"11":{},"14":{},"15":{}},"description":{"11":{}}}],["check",{"_index":1,"title":{},"description":{"0":{}}}],["client",{"_index":33,"title":{},"description":{"6":{}}}],["complet",{"_index":52,"title":{"11":{},"14":{},"15":{}},"description":{}}],["contain",{"_index":23,"title":{},"description":{"5":{}}}],["convo-starters-sidebar",{"_index":77,"title":{},"description":{"11":{}}}],["count",{"_index":126,"title":{"18":{}},"description":{"18":{}}}],["creat",{"_index":34,"title":{},"description":{"6":{}}}],["default",{"_index":99,"title":{},"description":{"12":{}}}],["dev",{"_index":54,"title":{},"description":{"11":{}}}],["e.g",{"_index":139,"title":{},"description":{"20":{}}}],["endpoint",{"_index":2,"title":{},"description":{"0":{},"3":{},"8":{},"10":{},"13":{},"14":{},"15":{},"16":{}}}],["exa",{"_index":95,"title":{},"description":{"12":{}}}],["experi",{"_index":101,"title":{},"description":{"12":{}}}],["experiment",{"_index":82,"title":{},"description":{"11":{},"12":{}}}],["first",{"_index":36,"title":{},"description":{"6":{},"11":{}}}],["flow",{"_index":14,"title":{},"description":{"5":{}}}],["fxa",{"_index":53,"title":{},"description":{"11":{},"12":{}}}],["gener",{"_index":32,"title":{},"description":{"6":{}}}],["group",{"_index":128,"title":{},"description":{"18":{}}}],["header",{"_index":31,"title":{},"description":{"5":{},"11":{},"12":{}}}],["health",{"_index":0,"title":{"0":{}},"description":{"0":{}}}],["health/liv",{"_index":5,"title":{},"description":{"1":{}}}],["health/readi",{"_index":7,"title":{},"description":{"2":{}}}],["higher",{"_index":140,"title":{},"description":{"20":{}}}],["info",{"_index":147,"title":{"24":{}},"description":{}}],["int",{"_index":107,"title":{},"description":{"12":{}}}],["integr",{"_index":47,"title":{"8":{},"9":{}},"description":{"8":{},"11":{},"12":{}}}],["interact",{"_index":50,"title":{},"description":{"10":{}}}],["io",{"_index":12,"title":{},"description":{"5":{},"6":{},"11":{}}}],["jwt",{"_index":22,"title":{},"description":{"5":{},"7":{},"11":{},"12":{}}}],["jwt-onli",{"_index":116,"title":{},"description":{"15":{}}}],["key",{"_index":26,"title":{},"description":{"5":{},"6":{}}}],["latenc",{"_index":113,"title":{},"description":{"14":{},"15":{}}}],["limit",{"_index":141,"title":{},"description":{"20":{}}}],["list",{"_index":123,"title":{"17":{}},"description":{"17":{}}}],["litellm",{"_index":49,"title":{"10":{}},"description":{"10":{},"12":{},"14":{},"15":{}}}],["live",{"_index":3,"title":{"1":{}},"description":{}}],["manag",{"_index":120,"title":{"16":{}},"description":{"16":{},"19":{}}}],["master_key",{"_index":131,"title":{},"description":{"18":{}}}],["match",{"_index":43,"title":{},"description":{"7":{}}}],["max_result",{"_index":106,"title":{},"description":{"12":{}}}],["memori",{"_index":66,"title":{},"description":{"11":{}}}],["memories-dev",{"_index":68,"title":{},"description":{"11":{}}}],["memory-gener",{"_index":78,"title":{},"description":{"11":{}}}],["metric",{"_index":8,"title":{"3":{},"4":{}},"description":{"3":{},"4":{}}}],["mlpa",{"_index":60,"title":{},"description":{"11":{},"12":{}}}],["mlpa_ui_access_key",{"_index":130,"title":{},"description":{"18":{},"19":{}}}],["mochi-dev",{"_index":69,"title":{},"description":{"11":{}}}],["mock",{"_index":110,"title":{"13":{}},"description":{"13":{},"14":{},"15":{}}}],["mock/chat/complet",{"_index":114,"title":{},"description":{"14":{}}}],["mock/chat/completions_no_auth",{"_index":118,"title":{},"description":{"15":{}}}],["oauth",{"_index":59,"title":{},"description":{"11":{},"12":{}}}],["object",{"_index":24,"title":{},"description":{"5":{},"7":{}}}],["obtain",{"_index":17,"title":{},"description":{"5":{}}}],["omit",{"_index":79,"title":{},"description":{"11":{}}}],["on",{"_index":62,"title":{},"description":{"11":{}}}],["pagin",{"_index":124,"title":{},"description":{"17":{}}}],["payload",{"_index":42,"title":{},"description":{"7":{},"8":{}}}],["play",{"_index":46,"title":{"8":{},"9":{}},"description":{"8":{},"11":{},"12":{}}}],["pool",{"_index":102,"title":{},"description":{"12":{}}}],["post",{"_index":20,"title":{},"description":{"5":{},"6":{},"15":{}}}],["probe",{"_index":4,"title":{"1":{},"2":{}},"description":{}}],["prometheu",{"_index":9,"title":{},"description":{"3":{}}}],["proxi",{"_index":94,"title":{},"description":{"12":{}}}],["purpos",{"_index":74,"title":{},"description":{"11":{},"12":{},"13":{}}}],["queri",{"_index":104,"title":{},"description":{"12":{}}}],["readi",{"_index":6,"title":{"2":{}},"description":{}}],["request",{"_index":28,"title":{},"description":{"5":{}}}],["requir",{"_index":57,"title":{},"description":{"11":{},"12":{}}}],["return",{"_index":85,"title":{},"description":{"11":{}}}],["s2",{"_index":64,"title":{},"description":{"11":{}}}],["s2s-android",{"_index":65,"title":{},"description":{"11":{}}}],["same",{"_index":97,"title":{},"description":{"12":{}}}],["schema",{"_index":45,"title":{},"description":{"7":{}}}],["search",{"_index":92,"title":{"12":{}},"description":{"12":{}}}],["search-dev",{"_index":100,"title":{},"description":{"12":{}}}],["servic",{"_index":83,"title":{"18":{}},"description":{"11":{},"19":{},"20":{}}}],["service-typ",{"_index":61,"title":{},"description":{"11":{},"12":{}}}],["service_typ",{"_index":129,"title":{},"description":{"18":{}}}],["set",{"_index":88,"title":{},"description":{"11":{}}}],["signup",{"_index":133,"title":{"19":{}},"description":{"19":{}}}],["simul",{"_index":112,"title":{},"description":{"14":{},"15":{}}}],["statu",{"_index":122,"title":{"19":{}},"description":{"16":{}}}],["str",{"_index":105,"title":{},"description":{"12":{}}}],["submit",{"_index":38,"title":{},"description":{"7":{}}}],["subsequ",{"_index":27,"title":{},"description":{"5":{}}}],["support",{"_index":125,"title":{},"description":{"17":{}}}],["telemetri",{"_index":71,"title":{},"description":{"11":{}}}],["test",{"_index":111,"title":{},"description":{"13":{}}}],["tier",{"_index":55,"title":{},"description":{"11":{},"20":{}}}],["title-gener",{"_index":76,"title":{},"description":{"11":{}}}],["token",{"_index":58,"title":{},"description":{"11":{},"12":{},"15":{}}}],["total",{"_index":127,"title":{},"description":{"18":{}}}],["track",{"_index":72,"title":{},"description":{"11":{}}}],["true",{"_index":89,"title":{},"description":{"11":{}}}],["type",{"_index":84,"title":{"18":{}},"description":{"11":{},"19":{},"20":{}}}],["unblock",{"_index":145,"title":{"22":{}},"description":{"22":{}}}],["updat",{"_index":137,"title":{"20":{}},"description":{"20":{}}}],["us",{"_index":25,"title":{},"description":{"5":{},"6":{},"7":{},"11":{},"12":{}}}],["use-app-attest",{"_index":30,"title":{},"description":{"5":{},"11":{}}}],["use-play-integr",{"_index":90,"title":{},"description":{"11":{}}}],["user",{"_index":119,"title":{"16":{},"17":{},"18":{},"20":{},"21":{},"22":{},"23":{},"24":{}},"description":{"16":{},"17":{},"18":{},"21":{},"22":{}}}],["user'",{"_index":138,"title":{},"description":{"20":{}}}],["user/counts-by-service-typ",{"_index":132,"title":{},"description":{"18":{}}}],["user/signup-cap-statu",{"_index":136,"title":{},"description":{"19":{}}}],["user/{user_id",{"_index":148,"title":{},"description":{"24":{}}}],["user/{user_id}/block",{"_index":144,"title":{},"description":{"21":{}}}],["user/{user_id}/budget",{"_index":142,"title":{},"description":{"20":{}}}],["user/{user_id}/unblock",{"_index":146,"title":{},"description":{"22":{}}}],["user_id",{"_index":143,"title":{},"description":{"21":{},"22":{}}}],["v1/chat/complet",{"_index":29,"title":{},"description":{"5":{},"11":{},"12":{}}}],["v1/search",{"_index":109,"title":{},"description":{"12":{}}}],["valid",{"_index":117,"title":{},"description":{"15":{}}}],["verif",{"_index":13,"title":{},"description":{"5":{},"7":{}}}],["verifi",{"_index":37,"title":{"7":{},"9":{}},"description":{"8":{}}}],["verify/attest",{"_index":21,"title":{},"description":{"5":{},"6":{},"7":{}}}],["verify/challeng",{"_index":16,"title":{},"description":{"5":{},"6":{},"7":{}}}],["verify/play",{"_index":48,"title":{},"description":{"9":{}}}],["via",{"_index":96,"title":{},"description":{"12":{}}}],["way",{"_index":98,"title":{},"description":{"12":{}}}],["web",{"_index":93,"title":{},"description":{"12":{}}}],["whose",{"_index":41,"title":{},"description":{"7":{}}}],["without",{"_index":87,"title":{},"description":{"11":{}}}],["x-dev-author",{"_index":80,"title":{},"description":{"11":{},"12":{}}}]],"pipeline":[]}},"options":{}};
 
       var container = document.getElementById('redoc');
       Redoc.hydrate(__redoc_state, container);
diff --git a/pyproject.toml b/pyproject.toml
index 112426a..ada6e7a 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "mlpa"
-version = "1.0.22"
+version = "1.0.23"
 description = "Authenticates and proxies LLM requests through LiteLLM to enact budgets and per-user management."
 authors = [
     { name = "Noah Podgurski", email = "npodgurski@mozilla.com" },
diff --git a/uv.lock b/uv.lock
index b818607..ae79c9e 100644
--- a/uv.lock
+++ b/uv.lock
@@ -729,7 +729,7 @@ wheels = [
 
 [[package]]
 name = "mlpa"
-version = "1.0.22"
+version = "1.0.23"
 source = { editable = "." }
 dependencies = [
     { name = "alembic" },