{"openapi":"3.1.0","info":{"title":"Bay Run","version":"1.7.2"},"paths":{"/v1/embeddings":{"post":{"summary":"Create Embeddings","operationId":"create_embeddings_v1_embeddings_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EmbeddingsRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"403":{"description":"Developer API key is missing a required scope"}},"security":[{"BearerAuth":[]},{"DeveloperApiKey":[]}],"x-bay-run-developer-api-key-scopes":["inference:invoke"]}},"/v1/rerank":{"post":{"summary":"Rerank Route","operationId":"rerank_route_v1_rerank_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RerankRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"403":{"description":"Developer API key is missing a required scope"}},"security":[{"BearerAuth":[]},{"DeveloperApiKey":[]}],"x-bay-run-developer-api-key-scopes":["inference:invoke"]}},"/v1/summarize":{"post":{"summary":"Summarize Route","operationId":"summarize_route_v1_summarize_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SummarizeRequest"}}}},"responses":{"200":{"description":"JSON by default; a UTF-8 server-sent event stream when stream=true.","content":{"application/json":{"schema":{}},"text/event-stream":{"schema":{"type":"string"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"403":{"description":"Developer API key is missing a required scope"}},"security":[{"BearerAuth":[]},{"DeveloperApiKey":[]}],"x-bay-run-developer-api-key-scopes":["inference:invoke"]}},"/v1/rag":{"post":{"summary":"Rag Route","operationId":"rag_route_v1_rag_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RagRequest"}}}},"responses":{"200":{"description":"JSON by default; a UTF-8 server-sent event stream when stream=true.","content":{"application/json":{"schema":{}},"text/event-stream":{"schema":{"type":"string"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"403":{"description":"Developer API key is missing a required scope"}},"security":[{"BearerAuth":[]},{"DeveloperApiKey":[]}],"x-bay-run-developer-api-key-scopes":["inference:invoke"]}},"/v1/pdf/extract":{"post":{"summary":"Pdf Extract Route","operationId":"pdf_extract_route_v1_pdf_extract_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PdfExtractRequest"}}}},"responses":{"200":{"description":"JSON by default; a UTF-8 server-sent event stream when stream=true.","content":{"application/json":{"schema":{}},"text/event-stream":{"schema":{"type":"string"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"403":{"description":"Developer API key is missing a required scope"}},"security":[{"BearerAuth":[]},{"DeveloperApiKey":[]}],"x-bay-run-developer-api-key-scopes":["inference:invoke"]}},"/v1/pdf/extract/upload":{"post":{"summary":"Upload and extract a bounded PDF","description":"Upload one local PDF without base64 expansion as a raw application/pdf or application/octet-stream body; controls are query parameters. The request body, upload wall time, admitted concurrency, PDFium worker memory/time, page count, and extracted characters are bounded. Returns the same page-aligned and RAG-ready contract as POST /v1/pdf/extract. Multipart is intentionally not accepted.","operationId":"pdf_extract_upload_route_v1_pdf_extract_upload_post","parameters":[{"name":"start_page","in":"query","required":false,"schema":{"type":"integer","minimum":1,"description":"First page, one-based.","default":1,"title":"Start Page"},"description":"First page, one-based."},{"name":"max_pages","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","maximum":100,"minimum":1},{"type":"null"}],"description":"Maximum pages to extract.","title":"Max Pages"},"description":"Maximum pages to extract."},{"name":"max_chars","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","maximum":400000,"minimum":1},{"type":"null"}],"description":"Maximum extracted characters.","title":"Max Chars"},"description":"Maximum extracted characters."},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"400":{"description":"Malformed PDF request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BayRunErrorEnvelope"}}}},"401":{"description":"Authentication required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BayRunErrorEnvelope"}}}},"408":{"description":"Upload ingestion deadline exceeded.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BayRunErrorEnvelope"}}}},"413":{"description":"PDF exceeds its byte cap.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BayRunErrorEnvelope"}}}},"415":{"description":"Unsupported upload media type.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BayRunErrorEnvelope"}}}},"422":{"description":"Invalid PDF or query bounds.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BayRunErrorEnvelope"}}}},"429":{"description":"Rate limit exceeded.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BayRunErrorEnvelope"}}}},"503":{"description":"Admission or parser worker unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BayRunErrorEnvelope"}}}},"504":{"description":"Hard PDF parse deadline exceeded.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BayRunErrorEnvelope"}}}},"403":{"description":"Developer API key is missing a required scope"}},"requestBody":{"required":true,"content":{"application/pdf":{"schema":{"type":"string","format":"binary"}},"application/octet-stream":{"schema":{"type":"string","format":"binary"}}}},"x-bay-run-limits":{"max_file_bytes":16777216,"upload_timeout_seconds":10.0,"queue_timeout_seconds":2.0,"worker_start_timeout_seconds":30.0,"parse_timeout_seconds":15.0,"parser_worker_memory_bytes":805306368,"parser_workers":2,"max_pending_requests":2,"default_max_pages":32,"hard_max_pages":100,"default_max_chars":200000,"hard_max_chars":400000},"x-bay-run-telemetry":{"scope":"server handler after authentication","request_body_ingress_included":true,"inbound_tls_and_pre_handler_auth_included":false,"phases":["admission_ms","upload_read_ms","source_ms","staging_ms","worker_start_ms","worker_queue_ms","worker_roundtrip_ms","executor_dispatch_ms","total_ms"],"headers":["x-bay-run-latency-ms","Server-Timing"]},"security":[{"BearerAuth":[]},{"DeveloperApiKey":[]}],"x-bay-run-developer-api-key-scopes":["inference:invoke"]}},"/v1/document/extract":{"post":{"summary":"Document Extract Route","operationId":"document_extract_route_v1_document_extract_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DocumentExtractRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"403":{"description":"Developer API key is missing a required scope"}},"security":[{"BearerAuth":[]},{"DeveloperApiKey":[]}],"x-bay-run-developer-api-key-scopes":["inference:invoke"]}},"/v1/chat/completions":{"post":{"summary":"Chat Completions","operationId":"chat_completions_v1_chat_completions_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ChatCompletionsRequest"}}}},"responses":{"200":{"description":"JSON by default; a UTF-8 server-sent event stream when stream=true.","content":{"application/json":{"schema":{}},"text/event-stream":{"schema":{"type":"string"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"403":{"description":"Developer API key is missing a required scope"}},"security":[{"BearerAuth":[]},{"DeveloperApiKey":[]}],"x-bay-run-developer-api-key-scopes":["inference:invoke"]}},"/v1/route":{"post":{"summary":"Route Endpoint","operationId":"route_endpoint_v1_route_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RouteRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"403":{"description":"Developer API key is missing a required scope"}},"security":[{"BearerAuth":[]},{"DeveloperApiKey":[]}],"x-bay-run-developer-api-key-scopes":["inference:invoke"]}},"/v1/discover":{"post":{"summary":"Discover","operationId":"discover_v1_discover_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DiscoverRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"403":{"description":"Developer API key is missing a required scope"}},"security":[{"BearerAuth":[]},{"DeveloperApiKey":[]}],"x-bay-run-developer-api-key-scopes":["inference:invoke"]}},"/v1/eval":{"post":{"summary":"Evaluate","operationId":"evaluate_v1_eval_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EvalRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"403":{"description":"Developer API key is missing a required scope"}},"security":[{"BearerAuth":[]},{"DeveloperApiKey":[]}],"x-bay-run-developer-api-key-scopes":["inference:invoke"]}},"/v1/find_specialist":{"post":{"summary":"Find Specialist","operationId":"find_specialist_v1_find_specialist_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FindSpecialistRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"403":{"description":"Developer API key is missing a required scope"}},"security":[{"BearerAuth":[]},{"DeveloperApiKey":[]}],"x-bay-run-developer-api-key-scopes":["inference:invoke"]}},"/v1/classify":{"post":{"summary":"Classify Route","operationId":"classify_route_v1_classify_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ClassifyRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"403":{"description":"Developer API key is missing a required scope"}},"security":[{"BearerAuth":[]},{"DeveloperApiKey":[]}],"x-bay-run-developer-api-key-scopes":["inference:invoke"]}},"/v1/request_specialist":{"post":{"summary":"Request Specialist Route","operationId":"request_specialist_route_v1_request_specialist_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RequestSpecialistRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"403":{"description":"Developer API key is missing a required scope"}},"security":[{"BearerAuth":[]},{"DeveloperApiKey":[]}],"x-bay-run-developer-api-key-scopes":["inference:invoke"]}},"/v1/feature-requests":{"post":{"summary":"Create Feature Catalog Request","operationId":"create_feature_catalog_request_v1_feature_requests_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FeatureCatalogRequest"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CatalogRequestSubmissionResponse"}}}},"200":{"description":"Exact replay receipt","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CatalogRequestSubmissionResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"403":{"description":"Developer API key is missing a required scope"}},"security":[{"BearerAuth":[]},{"DeveloperApiKey":[]}],"x-bay-run-developer-api-key-scopes":["requests:write"]}},"/v1/mirror-requests":{"post":{"summary":"Create Mirror Catalog Request","operationId":"create_mirror_catalog_request_v1_mirror_requests_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MirrorCatalogRequest"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CatalogRequestSubmissionResponse"}}}},"200":{"description":"Exact replay receipt","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CatalogRequestSubmissionResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"403":{"description":"Developer API key is missing a required scope"}},"security":[{"BearerAuth":[]},{"DeveloperApiKey":[]}],"x-bay-run-developer-api-key-scopes":["requests:write"]}},"/v1/source-requests":{"post":{"summary":"Create Source Catalog Request","operationId":"create_source_catalog_request_v1_source_requests_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SourceCatalogRequest"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CatalogRequestSubmissionResponse"}}}},"200":{"description":"Exact replay receipt","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CatalogRequestSubmissionResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"403":{"description":"Developer API key is missing a required scope"}},"security":[{"BearerAuth":[]},{"DeveloperApiKey":[]}],"x-bay-run-developer-api-key-scopes":["requests:write"]}},"/v1/request-status":{"get":{"summary":"List Catalog Request Status","operationId":"list_catalog_request_status_v1_request_status_get","parameters":[{"name":"kind","in":"query","required":false,"schema":{"enum":["","feature","mirror","source"],"type":"string","default":"","title":"Kind"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":25,"title":"Limit"}},{"name":"all_requests","in":"query","required":false,"schema":{"type":"boolean","description":"Operator-only cross-principal view.","default":false,"title":"All Requests"},"description":"Operator-only cross-principal view."},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CatalogRequestStatusListResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"403":{"description":"Developer API key is missing a required scope"}},"security":[{"BearerAuth":[]},{"DeveloperApiKey":[]}],"x-bay-run-developer-api-key-scopes":["requests:read"]}},"/v1/request-status/{request_id}":{"get":{"summary":"Get Catalog Request Status","operationId":"get_catalog_request_status_v1_request_status__request_id__get","parameters":[{"name":"request_id","in":"path","required":true,"schema":{"type":"string","pattern":"^brr_[A-Za-z0-9_-]{16,64}$","title":"Request Id"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CatalogRequestReceiptResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"403":{"description":"Developer API key is missing a required scope"}},"security":[{"BearerAuth":[]},{"DeveloperApiKey":[]}],"x-bay-run-developer-api-key-scopes":["requests:read"]},"patch":{"summary":"Moderate Catalog Request","operationId":"moderate_catalog_request_v1_request_status__request_id__patch","parameters":[{"name":"request_id","in":"path","required":true,"schema":{"type":"string","pattern":"^brr_[A-Za-z0-9_-]{16,64}$","title":"Request Id"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CatalogRequestModeration"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CatalogRequestReceiptResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/open-source-radar":{"get":{"summary":"Open Source Radar Route","operationId":"open_source_radar_route_v1_open_source_radar_get","parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":25,"minimum":1,"default":10,"title":"Limit"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OpenSourceRadarResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"403":{"description":"Developer API key is missing a required scope"}},"security":[{"BearerAuth":[]},{"DeveloperApiKey":[]}],"x-bay-run-developer-api-key-scopes":["requests:read"]}},"/v1/speed-test":{"post":{"summary":"Speed Test Route","operationId":"speed_test_route_v1_speed_test_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"403":{"description":"Developer API key is missing a required scope"}},"security":[{"BearerAuth":[]},{"DeveloperApiKey":[]}],"x-bay-run-developer-api-key-scopes":["inference:invoke"]}},"/v1/jobs":{"post":{"summary":"Submit Job Route","operationId":"submit_job_route_v1_jobs_post","parameters":[{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","title":"Idempotency-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BatchJobRequest"}}}},"responses":{"202":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"403":{"description":"Developer API key is missing a required scope"}},"security":[{"BearerAuth":[]},{"DeveloperApiKey":[]}],"x-bay-run-developer-api-key-scopes":["jobs:write"],"x-bay-run-idempotency-key-required":true,"x-bay-run-job-contract":{"schema":"bay-run.batch-job-request.v1","operations":["embeddings","rerank","classify","summarize","pdf_extract","calculate","validate_json","resolve_link"],"statuses":["queued","running","completed","failed","cancelled"],"paid_operations_supported":false,"shared_demo_principal_supported":false,"open_auth_principal_supported":false,"cancellation":"queued_only","retention_policy":"earliest_of_ttl_or_row_cap","quotas":{"max_items":8,"max_request_bytes":524288,"max_result_bytes":8388608,"max_active_per_principal":2,"max_active_global":32,"max_active_items_per_principal":16,"max_active_items_global":256,"max_attempts":3,"result_ttl_seconds":86400,"max_retained_per_principal":32,"max_retained_global":256}}}},"/v1/jobs/{job_id}":{"get":{"summary":"Get Job Route","operationId":"get_job_route_v1_jobs__job_id__get","parameters":[{"name":"job_id","in":"path","required":true,"schema":{"type":"string","title":"Job Id"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"403":{"description":"Developer API key is missing a required scope"}},"security":[{"BearerAuth":[]},{"DeveloperApiKey":[]}],"x-bay-run-developer-api-key-scopes":["jobs:read"]}},"/v1/jobs/{job_id}/cancel":{"post":{"summary":"Cancel Job Route","operationId":"cancel_job_route_v1_jobs__job_id__cancel_post","parameters":[{"name":"job_id","in":"path","required":true,"schema":{"type":"string","title":"Job Id"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"403":{"description":"Developer API key is missing a required scope"}},"security":[{"BearerAuth":[]},{"DeveloperApiKey":[]}],"x-bay-run-developer-api-key-scopes":["jobs:write"]}},"/v1/jobs/{job_id}/result":{"get":{"summary":"Get Job Result Route","operationId":"get_job_result_route_v1_jobs__job_id__result_get","parameters":[{"name":"job_id","in":"path","required":true,"schema":{"type":"string","title":"Job Id"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"403":{"description":"Developer API key is missing a required scope"}},"security":[{"BearerAuth":[]},{"DeveloperApiKey":[]}],"x-bay-run-developer-api-key-scopes":["jobs:read"]}},"/v1/models":{"get":{"summary":"List Models","operationId":"list_models_v1_models_get","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"403":{"description":"Developer API key is missing a required scope"}},"security":[{"BearerAuth":[]},{"DeveloperApiKey":[]}],"x-bay-run-developer-api-key-scopes":["models:read"]}},"/v1/cache":{"get":{"summary":"Cache Status","operationId":"cache_status_v1_cache_get","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"403":{"description":"Developer API key is missing a required scope"}},"security":[{"BearerAuth":[]},{"DeveloperApiKey":[]}],"x-bay-run-developer-api-key-scopes":["models:read"]}},"/v1/metrics":{"get":{"summary":"Funnel Metrics","operationId":"funnel_metrics_v1_metrics_get","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"BearerAuth":[]}]}},"/healthz":{"get":{"summary":"Healthz","operationId":"healthz_healthz_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[]}},"/health":{"get":{"summary":"Healthz","operationId":"healthz_health_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[]}},"/v1/try":{"get":{"summary":"Try Bay Run Route","description":"Zero-credential activation proof with no caller-controlled compute.","operationId":"try_bay_run_route_v1_try_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[]}},"/":{"get":{"summary":"Service Root","description":"Public liveness + self-description (no auth). Lets a scanner hitting the bare\nservice URL see a 200 describing the service and the discovery surfaces.","operationId":"service_root__get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[]}},"/.well-known/performance.json":{"get":{"summary":"Wellknown Performance","description":"Public benchmark protocol only; running the benchmark remains offline.","operationId":"wellknown_performance__well_known_performance_json_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[]}},"/.well-known/performance":{"get":{"summary":"Wellknown Performance","description":"Public benchmark protocol only; running the benchmark remains offline.","operationId":"wellknown_performance__well_known_performance_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[]}},"/agents.txt":{"get":{"summary":"Serve Llms Txt","description":"Public /llms.txt so an agent hitting the service URL learns the endpoints, the 25\ntools, find_specialist_for_task, and how to get a token/pay. No auth, no token leak.\n/agents.txt is an additive discovery-path alias (agent-oriented plaintext pointer)\nserving the identical body — crawlers probe both conventions.","operationId":"serve_llms_txt_agents_txt_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[]}},"/llms.txt":{"get":{"summary":"Serve Llms Txt","description":"Public /llms.txt so an agent hitting the service URL learns the endpoints, the 25\ntools, find_specialist_for_task, and how to get a token/pay. No auth, no token leak.\n/agents.txt is an additive discovery-path alias (agent-oriented plaintext pointer)\nserving the identical body — crawlers probe both conventions.","operationId":"serve_llms_txt_llms_txt_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[]}},"/llms-full.txt":{"get":{"summary":"Serve Llms Full Txt","description":"Public /llms-full.txt — fuller machine-facing reference. No auth, no token leak.","operationId":"serve_llms_full_txt_llms_full_txt_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[]}},"/.well-known/mcp/server-card.json":{"get":{"summary":"Serve Server Card","description":"Public MCP server card (no auth) so registry scanners + agents can enumerate the\nserver + all tools without the bearer that otherwise hides the tool list.","operationId":"serve_server_card__well_known_mcp_server_card_json_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[]}},"/a2a":{"get":{"summary":"A2A Discovery Get","description":"Compatibility discovery for crawlers that probe the A2A RPC URL.","operationId":"a2a_discovery_get_a2a_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[]},"post":{"summary":"A2A activation trial","operationId":"a2a_endpoint_a2a_post","responses":{"200":{"description":"Completed A2A activation task","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Invalid JSON-RPC request"}},"security":[],"description":"Send a standard A2A JSON-RPC message/send request for the fixed public activation proof. The returned task id is bay-run-public-trial-v1; no bearer is required.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["jsonrpc","method","params"]},"example":{"jsonrpc":"2.0","id":"trial-1","method":"message/send","params":{"message":{"messageId":"trial-message-1","role":"user","parts":[{"kind":"text","text":"Try Bay Run"}]}}}}}}}},"/.well-known/agent-directory.json":{"get":{"summary":"Serve Agent Card","description":"Public A2A (Agent2Agent) agent card (no auth). A2A clients discover this peer agent\nhere — identity, transport URL, skills, and auth. /.well-known/agent.json is served as a\nlegacy alias for older A2A clients. /agents.json, /.well-known/agents.json,\n/agent-directory.json and /.well-known/agent-directory.json are additive discovery-path\naliases (agent-directory conventions probed by registry crawlers) — identical body.","operationId":"serve_agent_card__well_known_agent_directory_json_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[]}},"/agent-directory.json":{"get":{"summary":"Serve Agent Card","description":"Public A2A (Agent2Agent) agent card (no auth). A2A clients discover this peer agent\nhere — identity, transport URL, skills, and auth. /.well-known/agent.json is served as a\nlegacy alias for older A2A clients. /agents.json, /.well-known/agents.json,\n/agent-directory.json and /.well-known/agent-directory.json are additive discovery-path\naliases (agent-directory conventions probed by registry crawlers) — identical body.","operationId":"serve_agent_card_agent_directory_json_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[]}},"/.well-known/agents.json":{"get":{"summary":"Serve Agent Card","description":"Public A2A (Agent2Agent) agent card (no auth). A2A clients discover this peer agent\nhere — identity, transport URL, skills, and auth. /.well-known/agent.json is served as a\nlegacy alias for older A2A clients. /agents.json, /.well-known/agents.json,\n/agent-directory.json and /.well-known/agent-directory.json are additive discovery-path\naliases (agent-directory conventions probed by registry crawlers) — identical body.","operationId":"serve_agent_card__well_known_agents_json_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[]}},"/agents.json":{"get":{"summary":"Serve Agent Card","description":"Public A2A (Agent2Agent) agent card (no auth). A2A clients discover this peer agent\nhere — identity, transport URL, skills, and auth. /.well-known/agent.json is served as a\nlegacy alias for older A2A clients. /agents.json, /.well-known/agents.json,\n/agent-directory.json and /.well-known/agent-directory.json are additive discovery-path\naliases (agent-directory conventions probed by registry crawlers) — identical body.","operationId":"serve_agent_card_agents_json_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[]}},"/.well-known/agent.json":{"get":{"summary":"Serve Agent Card","description":"Public A2A (Agent2Agent) agent card (no auth). A2A clients discover this peer agent\nhere — identity, transport URL, skills, and auth. /.well-known/agent.json is served as a\nlegacy alias for older A2A clients. /agents.json, /.well-known/agents.json,\n/agent-directory.json and /.well-known/agent-directory.json are additive discovery-path\naliases (agent-directory conventions probed by registry crawlers) — identical body.","operationId":"serve_agent_card__well_known_agent_json_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[]}},"/.well-known/agent-card.json":{"get":{"summary":"Serve Agent Card","description":"Public A2A (Agent2Agent) agent card (no auth). A2A clients discover this peer agent\nhere — identity, transport URL, skills, and auth. /.well-known/agent.json is served as a\nlegacy alias for older A2A clients. /agents.json, /.well-known/agents.json,\n/agent-directory.json and /.well-known/agent-directory.json are additive discovery-path\naliases (agent-directory conventions probed by registry crawlers) — identical body.","operationId":"serve_agent_card__well_known_agent_card_json_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[]}},"/mcp/.well-known/oauth-protected-resource":{"get":{"summary":"Oauth Protected Resource","description":"RFC 9728 protected-resource metadata (public). This is the document an\nOAuth-based MCP client fetches after a 401 to learn which AS issues tokens.\n/mcp/.well-known/oauth-protected-resource is an additive alias for clients that\nlook for the metadata nested under the MCP resource path (identical body; the\n`resource` field already points at the /mcp/ endpoint). Registered before the\n/mcp mount so it resolves here rather than the mounted sub-app.","operationId":"oauth_protected_resource_mcp__well_known_oauth_protected_resource_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[]}},"/.well-known/oauth-protected-resource/mcp":{"get":{"summary":"Oauth Protected Resource","description":"RFC 9728 protected-resource metadata (public). This is the document an\nOAuth-based MCP client fetches after a 401 to learn which AS issues tokens.\n/mcp/.well-known/oauth-protected-resource is an additive alias for clients that\nlook for the metadata nested under the MCP resource path (identical body; the\n`resource` field already points at the /mcp/ endpoint). Registered before the\n/mcp mount so it resolves here rather than the mounted sub-app.","operationId":"oauth_protected_resource__well_known_oauth_protected_resource_mcp_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[]}},"/.well-known/oauth-protected-resource":{"get":{"summary":"Oauth Protected Resource","description":"RFC 9728 protected-resource metadata (public). This is the document an\nOAuth-based MCP client fetches after a 401 to learn which AS issues tokens.\n/mcp/.well-known/oauth-protected-resource is an additive alias for clients that\nlook for the metadata nested under the MCP resource path (identical body; the\n`resource` field already points at the /mcp/ endpoint). Registered before the\n/mcp mount so it resolves here rather than the mounted sub-app.","operationId":"oauth_protected_resource__well_known_oauth_protected_resource_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[]}},"/mcp/.well-known/oauth-authorization-server":{"get":{"summary":"Oauth Authorization Server","description":"RFC 8414 authorization-server metadata (public). /mcp/.well-known/oauth-authorization-server\nis an additive alias for clients that probe under the MCP resource path (identical\nbody — AS metadata is resource-independent). Registered before the /mcp mount.","operationId":"oauth_authorization_server_mcp__well_known_oauth_authorization_server_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[]}},"/.well-known/oauth-authorization-server/mcp":{"get":{"summary":"Oauth Authorization Server","description":"RFC 8414 authorization-server metadata (public). /mcp/.well-known/oauth-authorization-server\nis an additive alias for clients that probe under the MCP resource path (identical\nbody — AS metadata is resource-independent). Registered before the /mcp mount.","operationId":"oauth_authorization_server__well_known_oauth_authorization_server_mcp_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[]}},"/.well-known/oauth-authorization-server":{"get":{"summary":"Oauth Authorization Server","description":"RFC 8414 authorization-server metadata (public). /mcp/.well-known/oauth-authorization-server\nis an additive alias for clients that probe under the MCP resource path (identical\nbody — AS metadata is resource-independent). Registered before the /mcp mount.","operationId":"oauth_authorization_server__well_known_oauth_authorization_server_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[]}},"/oauth/register":{"post":{"summary":"Oauth Register","description":"RFC 7591 stateless registration for public or durable machine clients.","operationId":"oauth_register_oauth_register_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[]}},"/oauth/authorize":{"get":{"summary":"Oauth Authorize","description":"PKCE-S256 authorization endpoint. AUTO-APPROVES (no interactive login) and\nissues a signed, short-lived authorization code bound to the PKCE challenge and\nredirect_uri. The credential this ultimately vends is the publishable, per-IP\nrate-limited demo tier, so auto-approval grants no privilege escalation.","operationId":"oauth_authorize_oauth_authorize_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[]}},"/oauth/token":{"post":{"summary":"Oauth Token","description":"Token endpoint. Supports three grants, all vending the DEMO tier:\nTHE DEMO TIER (the operator token is never issued):\n\n  * authorization_code — the interactive PKCE flow (verifies the signed code\n    + code_verifier). Used by browser/MCP-client OAuth.\n  * client_credentials — the machine-to-machine grant (mvp13.5). An\n    AUTONOMOUS agent with NO human at a browser can obtain a demo-tier\n    credential directly, closing the self-serve conversion wall. No PKCE /\n    code is needed; the vended tier is already the publishable, per-IP\n    rate-limited demo tier so there is no privilege to escalate. A client\n    registered via /oauth/register (public, token_endpoint_auth_method=none)\n    may pass its client_id but it is not required.\n  * refresh_token — renews the same private agent identity so durable memory\n    remains reachable across access-token expiry and across harnesses.","operationId":"oauth_token_oauth_token_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[]}},"/v1/developer/credentials":{"post":{"summary":"Create Developer Credential","description":"Create an OAuth-owned key and display its raw secret exactly once.","operationId":"create_developer_credential_v1_developer_credentials_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperCredentialCreateRequest"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperCredentialSecretResponse"}}},"headers":{"Cache-Control":{"description":"Always no-store for one-time secret responses.","schema":{"type":"string","enum":["no-store"]}},"Pragma":{"description":"Legacy no-cache protection for the one-time secret.","schema":{"type":"string","enum":["no-cache"]}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"BearerAuth":[]}],"x-bay-run-oauth-principal-required":true,"x-bay-run-secret-display":"once"},"get":{"summary":"List Developer Credentials","description":"List bounded non-secret metadata for keys owned by this OAuth principal.","operationId":"list_developer_credentials_v1_developer_credentials_get","parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":50,"title":"Limit"}},{"name":"cursor","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cursor"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperCredentialListResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"BearerAuth":[]}],"x-bay-run-oauth-principal-required":true,"x-bay-run-max-page-size":100}},"/v1/developer/credentials/{credential_id}/rotate":{"post":{"summary":"Rotate Developer Credential","description":"Atomically invalidate the old key and display its replacement once.","operationId":"rotate_developer_credential_v1_developer_credentials__credential_id__rotate_post","parameters":[{"name":"credential_id","in":"path","required":true,"schema":{"type":"string","title":"Credential Id"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperCredentialSecretResponse"}}},"headers":{"Cache-Control":{"description":"Always no-store for one-time secret responses.","schema":{"type":"string","enum":["no-store"]}},"Pragma":{"description":"Legacy no-cache protection for the one-time secret.","schema":{"type":"string","enum":["no-cache"]}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"BearerAuth":[]}],"x-bay-run-oauth-principal-required":true,"x-bay-run-secret-display":"once"}},"/v1/developer/credentials/{credential_id}":{"delete":{"summary":"Revoke Developer Credential","description":"Revoke a key immediately; repeated revocation returns the same receipt.","operationId":"revoke_developer_credential_v1_developer_credentials__credential_id__delete","parameters":[{"name":"credential_id","in":"path","required":true,"schema":{"type":"string","title":"Credential Id"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperCredentialRevokeResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"BearerAuth":[]}],"x-bay-run-oauth-principal-required":true}},"/v1/developer/credentials/{credential_id}/receipts":{"get":{"summary":"List Developer Credential Receipts","description":"List bounded append-only lifecycle receipts for one owned credential.","operationId":"list_developer_credential_receipts_v1_developer_credentials__credential_id__receipts_get","parameters":[{"name":"credential_id","in":"path","required":true,"schema":{"type":"string","title":"Credential Id"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":50,"title":"Limit"}},{"name":"cursor","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cursor"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperCredentialReceiptListResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"BearerAuth":[]}],"x-bay-run-oauth-principal-required":true,"x-bay-run-max-page-size":100}},"/.well-known/x402.json":{"get":{"summary":"Wellknown X402","description":"Public, machine-readable x402 status and exact payment contract.","operationId":"wellknown_x402__well_known_x402_json_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[]},"head":{"summary":"Wellknown X402","description":"Public, machine-readable x402 status and exact payment contract.","operationId":"wellknown_x402__well_known_x402_json_head","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[]}},"/.well-known/x402":{"get":{"summary":"Wellknown X402","description":"Public, machine-readable x402 status and exact payment contract.","operationId":"wellknown_x402__well_known_x402_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[]},"head":{"summary":"Wellknown X402","description":"Public, machine-readable x402 status and exact payment contract.","operationId":"wellknown_x402__well_known_x402_head","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[]}},"/x402/chat/completions":{"post":{"summary":"X402 Payable","description":"Tokenless, pay-per-call twin of /v1/chat/completions.","operationId":"x402_payable_x402_chat_completions_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ChatCompletionsRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"402":{"description":"Payment Required; inspect the response payment challenge or Link header."}},"security":[],"x-payment-info":{"offers":[{"intent":"charge","method":"x402","amount":"5000","currency":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","description":"One chat completion settled in USDC on eip155:8453; the runtime 402 challenge is authoritative.","buyerRecipe":"https://run.huggingbay.xyz/.well-known/x402/recipes/base-mainnet-usdc"}]}}},"/v1/billing/stripe/checkout-session":{"post":{"summary":"Stripe Checkout Session","operationId":"stripe_checkout_session_v1_billing_stripe_checkout_session_post","parameters":[{"name":"Idempotency-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Idempotency-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/StripeCheckoutRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"403":{"description":"Developer API key is missing a required scope"}},"security":[{"BearerAuth":[]},{"DeveloperApiKey":[]}],"x-bay-run-developer-api-key-scopes":["billing:write"]}},"/v1/billing/balance":{"get":{"summary":"Stripe Credit Balance","operationId":"stripe_credit_balance_v1_billing_balance_get","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"403":{"description":"Developer API key is missing a required scope"}},"security":[{"BearerAuth":[]},{"DeveloperApiKey":[]}],"x-bay-run-developer-api-key-scopes":["billing:read"]}},"/v1/billing/usage":{"get":{"summary":"Stripe Credit Usage","description":"Export immutable receipts for this OAuth principal's committed credit calls.","operationId":"stripe_credit_usage_v1_billing_usage_get","parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":50,"title":"Limit"}},{"name":"cursor","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":1024},{"type":"null"}],"title":"Cursor"}},{"name":"format","in":"query","required":false,"schema":{"enum":["json","csv"],"type":"string","default":"json","title":"Format"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Committed prepaid-credit receipts for the authenticated principal","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StripeCreditUsagePage"}},"text/csv":{"schema":{"type":"string"}}},"headers":{"X-Bay-Run-Remaining-Credits":{"schema":{"type":"integer"},"description":"Current spendable credit balance"},"X-Bay-Run-Reserved-Credits":{"schema":{"type":"integer"},"description":"Credits reserved by in-flight calls"},"X-Bay-Run-Has-More":{"schema":{"type":"string","enum":["0","1"]},"description":"Whether another keyset page is available"},"X-Bay-Run-Next-Cursor":{"schema":{"type":"string"},"description":"Opaque cursor for the next page, when present"}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"403":{"description":"Developer API key is missing a required scope"}},"security":[{"BearerAuth":[]},{"DeveloperApiKey":[]}],"x-bay-run-developer-api-key-scopes":["billing:read"]}},"/v1/credits/chat/completions":{"post":{"summary":"Stripe Credit Chat Completions","operationId":"stripe_credit_chat_completions_v1_credits_chat_completions_post","parameters":[{"name":"Idempotency-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Idempotency-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ChatCompletionsRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"403":{"description":"Developer API key is missing a required scope"},"402":{"description":"Payment Required; inspect the response payment challenge or Link header."}},"security":[{"BearerAuth":[]},{"DeveloperApiKey":[]}],"x-bay-run-developer-api-key-scopes":["billing:write","inference:invoke"],"x-payment-info":{"offers":[{"intent":"session","method":"stripe","amount":"500","currency":"USD","description":"1000 successful credit-funded chat calls; purchase pack_code=starter_1000 at /v1/billing/stripe/checkout-session."},{"intent":"session","method":"stripe","amount":"2000","currency":"USD","description":"5000 successful credit-funded chat calls; purchase pack_code=builder_5000 at /v1/billing/stripe/checkout-session."}]},"x-bay-run-idempotency-key-required":true}},"/webhooks/stripe":{"post":{"summary":"Stripe Webhook","operationId":"stripe_webhook_webhooks_stripe_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[]}},"/mcp/.well-known/mcp.json":{"get":{"summary":"Wellknown Mcp Json","description":"Alias to the MCP server card so a client that probes /.well-known/mcp.json\n(rather than the /.well-known/mcp/server-card.json path) still discovers the\nserver + all 30 tools. /.well-known/mcp, /mcp.json, /mcp/.well-known/mcp and\n/mcp/.well-known/mcp.json are additive discovery-path aliases serving the identical\nserver-card body — crawlers probe every one of these conventions. The two /mcp/*\naliases are registered before the /mcp mount (below) so they resolve to this handler\nrather than the mounted streamable-HTTP sub-app.","operationId":"wellknown_mcp_json_mcp__well_known_mcp_json_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[]}},"/mcp/.well-known/mcp":{"get":{"summary":"Wellknown Mcp Json","description":"Alias to the MCP server card so a client that probes /.well-known/mcp.json\n(rather than the /.well-known/mcp/server-card.json path) still discovers the\nserver + all 30 tools. /.well-known/mcp, /mcp.json, /mcp/.well-known/mcp and\n/mcp/.well-known/mcp.json are additive discovery-path aliases serving the identical\nserver-card body — crawlers probe every one of these conventions. The two /mcp/*\naliases are registered before the /mcp mount (below) so they resolve to this handler\nrather than the mounted streamable-HTTP sub-app.","operationId":"wellknown_mcp_json_mcp__well_known_mcp_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[]}},"/mcp.json":{"get":{"summary":"Wellknown Mcp Json","description":"Alias to the MCP server card so a client that probes /.well-known/mcp.json\n(rather than the /.well-known/mcp/server-card.json path) still discovers the\nserver + all 30 tools. /.well-known/mcp, /mcp.json, /mcp/.well-known/mcp and\n/mcp/.well-known/mcp.json are additive discovery-path aliases serving the identical\nserver-card body — crawlers probe every one of these conventions. The two /mcp/*\naliases are registered before the /mcp mount (below) so they resolve to this handler\nrather than the mounted streamable-HTTP sub-app.","operationId":"wellknown_mcp_json_mcp_json_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[]}},"/.well-known/mcp":{"get":{"summary":"Wellknown Mcp Json","description":"Alias to the MCP server card so a client that probes /.well-known/mcp.json\n(rather than the /.well-known/mcp/server-card.json path) still discovers the\nserver + all 30 tools. /.well-known/mcp, /mcp.json, /mcp/.well-known/mcp and\n/mcp/.well-known/mcp.json are additive discovery-path aliases serving the identical\nserver-card body — crawlers probe every one of these conventions. The two /mcp/*\naliases are registered before the /mcp mount (below) so they resolve to this handler\nrather than the mounted streamable-HTTP sub-app.","operationId":"wellknown_mcp_json__well_known_mcp_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[]}},"/.well-known/mcp.json":{"get":{"summary":"Wellknown Mcp Json","description":"Alias to the MCP server card so a client that probes /.well-known/mcp.json\n(rather than the /.well-known/mcp/server-card.json path) still discovers the\nserver + all 30 tools. /.well-known/mcp, /mcp.json, /mcp/.well-known/mcp and\n/mcp/.well-known/mcp.json are additive discovery-path aliases serving the identical\nserver-card body — crawlers probe every one of these conventions. The two /mcp/*\naliases are registered before the /mcp mount (below) so they resolve to this handler\nrather than the mounted streamable-HTTP sub-app.","operationId":"wellknown_mcp_json__well_known_mcp_json_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[]}},"/.well-known/glama.json":{"get":{"summary":"Wellknown Glama","description":"Glama registry crawler manifest (the Glama crawler probes this path).","operationId":"wellknown_glama__well_known_glama_json_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[]}},"/mcp/.well-known/owners.json":{"get":{"summary":"Wellknown Owners","description":"Ownership-verification document some registries request.","operationId":"wellknown_owners_mcp__well_known_owners_json_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[]}},"/.well-known/owners.json":{"get":{"summary":"Wellknown Owners","description":"Ownership-verification document some registries request.","operationId":"wellknown_owners__well_known_owners_json_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[]}},"/mcp/":{"head":{"summary":"Mcp Liveness","description":"Bodyless transport liveness for harnesses that probe MCP with HEAD.","operationId":"mcp_liveness_mcp__head","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[]},"post":{"summary":"MCP Streamable HTTP transport","description":"POST a JSON-RPC 2.0 request or batch to the remote MCP transport. All JSON-RPC methods except tools/call are public discovery calls; tools/call requires a Bearer token except for the no-argument try_bay_run trial. Developer API keys require mcp:invoke, with additional least-privilege scopes for memory, asynchronous job, and provenance tools.","operationId":"mcp_transport_slash_post","tags":["mcp"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"oneOf":[{"$ref":"#/components/schemas/MCPJsonRpcRequest"},{"type":"array","minItems":1,"items":{"$ref":"#/components/schemas/MCPJsonRpcRequest"}}]},"examples":{"initialize":{"summary":"Start MCP capability negotiation","value":{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-06-18","capabilities":{},"clientInfo":{"name":"example-agent","version":"1.0.0"}}}},"tools_list":{"summary":"List the 30 public tool descriptors","value":{"jsonrpc":"2.0","id":2,"method":"tools/list"}},"resources_list":{"summary":"List public MCP resources","value":{"jsonrpc":"2.0","id":3,"method":"resources/list"}}}}}},"responses":{"200":{"description":"MCP JSON-RPC response","content":{"application/json":{"schema":{"oneOf":[{"type":"object"},{"type":"array","items":{"type":"object"}}]}}}},"202":{"description":"Notification accepted; no JSON-RPC response"},"400":{"description":"Invalid JSON-RPC request"},"401":{"description":"Bearer token required for this MCP tool call"},"403":{"description":"Developer API key is missing a required scope"}},"security":[],"x-bay-run-authentication":{"public_methods":["initialize","notifications/initialized","tools/list","prompts/list","resources/list","ping"],"public_method_policy":"all JSON-RPC methods except tools/call","public_tool_calls":["try_bay_run with no arguments"],"bearer_methods":["tools/call"],"developer_api_key":{"required_scopes":["mcp:invoke"],"tool_scope_overrides":{"recall":["mcp:invoke","memory:read"],"remember":["mcp:invoke","memory:write"],"forget":["mcp:invoke","memory:write"],"memory_context":["mcp:invoke","memory:read","memory:write"],"search_memory":["mcp:invoke","memory:read"],"export_memory":["mcp:invoke","memory:read"],"set_memory_ttl":["mcp:invoke","memory:write"],"submit_job":["jobs:write","mcp:invoke"],"cancel_job":["jobs:write","mcp:invoke"],"get_job":["jobs:read","mcp:invoke"],"get_job_result":["jobs:read","mcp:invoke"],"verify_provenance":["mcp:invoke","provenance:verify"]}}}}},"/mcp":{"head":{"summary":"Mcp Liveness","description":"Bodyless transport liveness for harnesses that probe MCP with HEAD.","operationId":"mcp_liveness_mcp_head","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[]},"post":{"summary":"MCP Streamable HTTP transport","description":"POST a JSON-RPC 2.0 request or batch to the remote MCP transport. All JSON-RPC methods except tools/call are public discovery calls; tools/call requires a Bearer token except for the no-argument try_bay_run trial. Developer API keys require mcp:invoke, with additional least-privilege scopes for memory, asynchronous job, and provenance tools.","operationId":"mcp_transport_post","tags":["mcp"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"oneOf":[{"$ref":"#/components/schemas/MCPJsonRpcRequest"},{"type":"array","minItems":1,"items":{"$ref":"#/components/schemas/MCPJsonRpcRequest"}}]},"examples":{"initialize":{"summary":"Start MCP capability negotiation","value":{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-06-18","capabilities":{},"clientInfo":{"name":"example-agent","version":"1.0.0"}}}},"tools_list":{"summary":"List the 30 public tool descriptors","value":{"jsonrpc":"2.0","id":2,"method":"tools/list"}},"resources_list":{"summary":"List public MCP resources","value":{"jsonrpc":"2.0","id":3,"method":"resources/list"}}}}}},"responses":{"200":{"description":"MCP JSON-RPC response","content":{"application/json":{"schema":{"oneOf":[{"type":"object"},{"type":"array","items":{"type":"object"}}]}}}},"202":{"description":"Notification accepted; no JSON-RPC response"},"400":{"description":"Invalid JSON-RPC request"},"401":{"description":"Bearer token required for this MCP tool call"},"403":{"description":"Developer API key is missing a required scope"}},"security":[],"x-bay-run-authentication":{"public_methods":["initialize","notifications/initialized","tools/list","prompts/list","resources/list","ping"],"public_method_policy":"all JSON-RPC methods except tools/call","public_tool_calls":["try_bay_run with no arguments"],"bearer_methods":["tools/call"],"developer_api_key":{"required_scopes":["mcp:invoke"],"tool_scope_overrides":{"recall":["mcp:invoke","memory:read"],"remember":["mcp:invoke","memory:write"],"forget":["mcp:invoke","memory:write"],"memory_context":["mcp:invoke","memory:read","memory:write"],"search_memory":["mcp:invoke","memory:read"],"export_memory":["mcp:invoke","memory:read"],"set_memory_ttl":["mcp:invoke","memory:write"],"submit_job":["jobs:write","mcp:invoke"],"cancel_job":["jobs:write","mcp:invoke"],"get_job":["jobs:read","mcp:invoke"],"get_job_result":["jobs:read","mcp:invoke"],"verify_provenance":["mcp:invoke","provenance:verify"]}}}}},"/robots.txt":{"get":{"summary":"Robots Txt","description":"Permissive robots.txt — welcomes AI/registry crawlers and names the XML sitemap.","operationId":"robots_txt_robots_txt_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[]}},"/payment":{"get":{"summary":"Pricing And Monetization","description":"Payment-discovery document (agents probe /pricing, /monetization, /payments,\n/payment, and the well-known variants). Describes the free demo tier + x402.","operationId":"pricing_and_monetization_payment_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[]}},"/payments":{"get":{"summary":"Pricing And Monetization","description":"Payment-discovery document (agents probe /pricing, /monetization, /payments,\n/payment, and the well-known variants). Describes the free demo tier + x402.","operationId":"pricing_and_monetization_payments_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[]}},"/.well-known/monetization":{"get":{"summary":"Pricing And Monetization","description":"Payment-discovery document (agents probe /pricing, /monetization, /payments,\n/payment, and the well-known variants). Describes the free demo tier + x402.","operationId":"pricing_and_monetization__well_known_monetization_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[]}},"/monetization":{"get":{"summary":"Pricing And Monetization","description":"Payment-discovery document (agents probe /pricing, /monetization, /payments,\n/payment, and the well-known variants). Describes the free demo tier + x402.","operationId":"pricing_and_monetization_monetization_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[]}},"/.well-known/pricing":{"get":{"summary":"Pricing And Monetization","description":"Payment-discovery document (agents probe /pricing, /monetization, /payments,\n/payment, and the well-known variants). Describes the free demo tier + x402.","operationId":"pricing_and_monetization__well_known_pricing_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[]}},"/pricing":{"get":{"summary":"Pricing And Monetization","description":"Payment-discovery document (agents probe /pricing, /monetization, /payments,\n/payment, and the well-known variants). Describes the free demo tier + x402.","operationId":"pricing_and_monetization_pricing_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[]}},"/v1/demand":{"get":{"summary":"Demand Readback","description":"OPERATOR-ONLY. Reads back the durable demand_requests store so the operator\n(and deploy verification) can confirm request_specialist no-match demand is\nPERSISTING to Cloud SQL (survives restart/scale), not the ephemeral JSONL.","operationId":"demand_readback_v1_demand_get","parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":10,"title":"Limit"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/billing":{"get":{"summary":"Billing Readback","description":"OPERATOR-ONLY. Durable x402 and Stripe-credit billing totals.","operationId":"billing_readback_v1_billing_get","parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":20,"title":"Limit"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/memory/context":{"post":{"summary":"Memory Context Route","description":"Load or atomically update a bounded durable working context in one round trip.","operationId":"memory_context_route_v1_memory_context_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MemoryContextRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MemoryToolResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"403":{"description":"Developer API key is missing a required scope"}},"security":[{"BearerAuth":[]},{"DeveloperApiKey":[]}],"x-bay-run-developer-api-key-scopes":["memory:read","memory:write"]}},"/v1/memory":{"post":{"summary":"Memory Write","description":"Upsert one durable (namespace, key) -> value for the caller's principal. REST twin\nof the `remember` MCP tool. Scoped to the bearer-token identity (multi-tenant isolation);\nsigned OAuth credentials use a private refreshable agent principal; the legacy static demo\ntoken remains shared and must not be used for secrets.","operationId":"memory_write_v1_memory_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MemoryWriteRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MemoryToolResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"403":{"description":"Developer API key is missing a required scope"}},"security":[{"BearerAuth":[]},{"DeveloperApiKey":[]}],"x-bay-run-developer-api-key-scopes":["memory:write"]},"get":{"summary":"Memory Read","description":"Read back memory for the caller's principal: one `key`, or LIST the namespace when\n`key` is omitted. List mode is row+byte bounded and returns next_cursor. REST twin of\n`recall`.","operationId":"memory_read_v1_memory_get","parameters":[{"name":"namespace","in":"query","required":true,"schema":{"type":"string","minLength":1,"maxLength":256,"title":"Namespace"}},{"name":"key","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":512},{"type":"null"}],"title":"Key"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":200,"minimum":1,"default":200,"title":"Limit"}},{"name":"cursor","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":2048},{"type":"null"}],"title":"Cursor"}},{"name":"max_bytes","in":"query","required":false,"schema":{"type":"integer","maximum":13926400,"minimum":69632,"default":13926400,"title":"Max Bytes"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MemoryToolResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"403":{"description":"Developer API key is missing a required scope"}},"security":[{"BearerAuth":[]},{"DeveloperApiKey":[]}],"x-bay-run-developer-api-key-scopes":["memory:read"]},"patch":{"summary":"Memory Set Ttl","description":"Set/refresh or clear TTL on one live entry without replacing its value.","operationId":"memory_set_ttl_v1_memory_patch","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MemoryTtlRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MemoryToolResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"403":{"description":"Developer API key is missing a required scope"}},"security":[{"BearerAuth":[]},{"DeveloperApiKey":[]}],"x-bay-run-developer-api-key-scopes":["memory:write"]},"delete":{"summary":"Memory Delete","description":"Delete memory for the caller's principal: one `key`, or the whole namespace when\n`key` is omitted. REST twin of `forget`. Returns {deleted: N}.","operationId":"memory_delete_v1_memory_delete","parameters":[{"name":"namespace","in":"query","required":true,"schema":{"type":"string","title":"Namespace"}},{"name":"key","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MemoryToolResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"403":{"description":"Developer API key is missing a required scope"}},"security":[{"BearerAuth":[]},{"DeveloperApiKey":[]}],"x-bay-run-developer-api-key-scopes":["memory:write"]}},"/v1/memory/search":{"get":{"summary":"Memory Search","description":"Search literal text in the caller's own live memory, with bounded pagination.","operationId":"memory_search_v1_memory_search_get","parameters":[{"name":"query","in":"query","required":true,"schema":{"type":"string","minLength":1,"maxLength":256,"title":"Query"}},{"name":"namespace","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":256},{"type":"null"}],"title":"Namespace"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":200,"minimum":1,"default":50,"title":"Limit"}},{"name":"cursor","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":2048},{"type":"null"}],"title":"Cursor"}},{"name":"max_bytes","in":"query","required":false,"schema":{"type":"integer","maximum":1048576,"minimum":69632,"default":262144,"title":"Max Bytes"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MemoryToolResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"403":{"description":"Developer API key is missing a required scope"}},"security":[{"BearerAuth":[]},{"DeveloperApiKey":[]}],"x-bay-run-developer-api-key-scopes":["memory:read"]}},"/v1/memory/export":{"get":{"summary":"Memory Export","description":"Export one versioned, bounded JSON page of the caller's live memory.","operationId":"memory_export_v1_memory_export_get","parameters":[{"name":"namespace","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":256},{"type":"null"}],"title":"Namespace"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":200,"minimum":1,"default":50,"title":"Limit"}},{"name":"cursor","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":2048},{"type":"null"}],"title":"Cursor"}},{"name":"max_bytes","in":"query","required":false,"schema":{"type":"integer","maximum":1048576,"minimum":69632,"default":262144,"title":"Max Bytes"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MemoryToolResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"403":{"description":"Developer API key is missing a required scope"}},"security":[{"BearerAuth":[]},{"DeveloperApiKey":[]}],"x-bay-run-developer-api-key-scopes":["memory:read"]}},"/v1/calculate":{"post":{"summary":"Calculate Route","description":"Safe arithmetic/math evaluation (no code execution). REST twin of the `calculate`\ntool. Returns {ok, result} or {ok:false, error}.","operationId":"calculate_route_v1_calculate_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CalculateRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"403":{"description":"Developer API key is missing a required scope"}},"security":[{"BearerAuth":[]},{"DeveloperApiKey":[]}],"x-bay-run-developer-api-key-scopes":["inference:invoke"]}},"/v1/validate_json":{"post":{"summary":"Validate Json Route","description":"Validate a JSON string/object, optionally against a JSON Schema. REST twin of the\n`validate_json` tool. Returns {valid, errors:[...], parsed}.","operationId":"validate_json_route_v1_validate_json_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ValidateJsonRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"403":{"description":"Developer API key is missing a required scope"}},"security":[{"BearerAuth":[]},{"DeveloperApiKey":[]}],"x-bay-run-developer-api-key-scopes":["inference:invoke"]}},"/v1/resolve_link":{"post":{"summary":"Resolve Link Route","description":"Liveness check + Hugging Bay mirror fallback for a URL. REST twin of `resolve_link`.\nSSRF-safe (http(s) only, no internal targets). Returns {alive, status, mirror_url?}.","operationId":"resolve_link_route_v1_resolve_link_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ResolveLinkRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"403":{"description":"Developer API key is missing a required scope"}},"security":[{"BearerAuth":[]},{"DeveloperApiKey":[]}],"x-bay-run-developer-api-key-scopes":["inference:invoke"]}},"/v1/provenance/verify":{"post":{"summary":"Verify Provenance Route","description":"REST twin of verify_provenance. Never echoes supplied evidence.","operationId":"verify_provenance_route_v1_provenance_verify_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/VerifyProvenanceRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"403":{"description":"Developer API key is missing a required scope"}},"security":[{"BearerAuth":[]},{"DeveloperApiKey":[]}],"x-bay-run-developer-api-key-scopes":["provenance:verify"]}}},"components":{"schemas":{"BatchJobRequest":{"properties":{"items":{"items":{"$ref":"#/components/schemas/JobItemRequest"},"type":"array","maxItems":8,"minItems":1,"title":"Items","description":"Bounded operations executed sequentially in submission order."}},"additionalProperties":false,"type":"object","required":["items"],"title":"BatchJobRequest"},"BayRunErrorEnvelope":{"properties":{"error":{"$ref":"#/components/schemas/BayRunErrorPayload"}},"type":"object","required":["error"],"title":"BayRunErrorEnvelope"},"BayRunErrorPayload":{"properties":{"code":{"type":"string","title":"Code"},"reason":{"type":"string","title":"Reason"},"retriable":{"type":"boolean","title":"Retriable"},"suggested_alternative_model":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Suggested Alternative Model"},"details":{"anyOf":[{},{"type":"null"}],"title":"Details"}},"type":"object","required":["code","reason","retriable"],"title":"BayRunErrorPayload"},"CalculateRequest":{"properties":{"expression":{"type":"string","title":"Expression","description":"Math expression to evaluate safely."}},"additionalProperties":false,"type":"object","required":["expression"],"title":"CalculateRequest"},"CatalogRequestActions":{"properties":{"status":{"type":"string","title":"Status"},"list":{"type":"string","title":"List"},"radar":{"type":"string","title":"Radar"}},"type":"object","required":["status","list","radar"],"title":"CatalogRequestActions"},"CatalogRequestModeration":{"properties":{"status":{"type":"string","enum":["received","reviewing","planned","fulfilled","declined","refused","blocked"],"title":"Status"},"hidden":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Hidden"},"note":{"type":"string","maxLength":500,"title":"Note","default":""},"reopen":{"type":"boolean","title":"Reopen","default":false}},"additionalProperties":false,"type":"object","required":["status"],"title":"CatalogRequestModeration"},"CatalogRequestPrivacy":{"properties":{"contactIncluded":{"type":"boolean","title":"Contactincluded"},"principalIncluded":{"type":"boolean","title":"Principalincluded"},"dedupeDigestIncluded":{"type":"boolean","title":"Dedupedigestincluded"}},"additionalProperties":false,"type":"object","required":["contactIncluded","principalIncluded","dedupeDigestIncluded"],"title":"CatalogRequestPrivacy"},"CatalogRequestReceiptResponse":{"properties":{"schema":{"type":"string","const":"bay-run.catalog-request.v1","title":"Schema"},"id":{"type":"string","pattern":"^brr_[A-Za-z0-9_-]{16,64}$","title":"Id"},"kind":{"type":"string","enum":["feature","mirror","source"],"title":"Kind"},"status":{"type":"string","enum":["received","reviewing","planned","fulfilled","declined","refused","blocked"],"title":"Status"},"targetId":{"type":"string","title":"Targetid"},"request":{"additionalProperties":true,"type":"object","title":"Request"},"createdAt":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Createdat"},"updatedAt":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Updatedat"},"lastSeenAt":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Lastseenat"},"submissionCount":{"type":"integer","minimum":1.0,"title":"Submissioncount"},"terminal":{"type":"boolean","title":"Terminal"},"automationEligible":{"type":"boolean","const":false,"title":"Automationeligible"},"queueEnqueued":{"type":"boolean","const":false,"title":"Queueenqueued"},"privacy":{"$ref":"#/components/schemas/CatalogRequestPrivacy"},"actions":{"$ref":"#/components/schemas/CatalogRequestActions"}},"additionalProperties":false,"type":"object","required":["schema","id","kind","status","targetId","request","createdAt","updatedAt","lastSeenAt","submissionCount","terminal","automationEligible","queueEnqueued","privacy","actions"],"title":"CatalogRequestReceiptResponse"},"CatalogRequestStatusListResponse":{"properties":{"schema":{"type":"string","const":"bay-run.catalog-request-status.v1","title":"Schema"},"rows":{"items":{"$ref":"#/components/schemas/CatalogRequestReceiptResponse"},"type":"array","title":"Rows"},"automationQueuesTouched":{"type":"boolean","const":false,"title":"Automationqueuestouched"}},"additionalProperties":false,"type":"object","required":["schema","rows","automationQueuesTouched"],"title":"CatalogRequestStatusListResponse"},"CatalogRequestSubmissionResponse":{"properties":{"schema":{"type":"string","const":"bay-run.catalog-request.v1","title":"Schema"},"id":{"type":"string","pattern":"^brr_[A-Za-z0-9_-]{16,64}$","title":"Id"},"kind":{"type":"string","enum":["feature","mirror","source"],"title":"Kind"},"status":{"type":"string","enum":["received","reviewing","planned","fulfilled","declined","refused","blocked"],"title":"Status"},"targetId":{"type":"string","title":"Targetid"},"request":{"additionalProperties":true,"type":"object","title":"Request"},"createdAt":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Createdat"},"updatedAt":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Updatedat"},"lastSeenAt":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Lastseenat"},"submissionCount":{"type":"integer","minimum":1.0,"title":"Submissioncount"},"terminal":{"type":"boolean","title":"Terminal"},"automationEligible":{"type":"boolean","const":false,"title":"Automationeligible"},"queueEnqueued":{"type":"boolean","const":false,"title":"Queueenqueued"},"privacy":{"$ref":"#/components/schemas/CatalogRequestPrivacy"},"actions":{"$ref":"#/components/schemas/CatalogRequestActions"},"created":{"type":"boolean","title":"Created"},"deduplicated":{"type":"boolean","title":"Deduplicated"}},"additionalProperties":false,"type":"object","required":["schema","id","kind","status","targetId","request","createdAt","updatedAt","lastSeenAt","submissionCount","terminal","automationEligible","queueEnqueued","privacy","actions","created","deduplicated"],"title":"CatalogRequestSubmissionResponse"},"ChatCompletionsRequest":{"properties":{"model":{"type":"string","title":"Model"},"messages":{"items":{"$ref":"#/components/schemas/ChatMessage"},"type":"array","title":"Messages"},"max_tokens":{"type":"integer","title":"Max Tokens","default":512},"max_completion_tokens":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Max Completion Tokens"},"temperature":{"type":"number","title":"Temperature","default":0.0},"response_format":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Response Format"},"stop":{"anyOf":[{"type":"string"},{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Stop"},"stream":{"type":"boolean","title":"Stream","default":false},"stream_options":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Stream Options"},"task_hint":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Task Hint"},"tools":{"anyOf":[{"items":{"$ref":"#/components/schemas/ChatFunctionTool"},"type":"array","maxItems":128,"minItems":1},{"type":"null"}],"title":"Tools"},"tool_choice":{"anyOf":[{"type":"string","enum":["none","auto","required"]},{"$ref":"#/components/schemas/ChatNamedToolChoice"},{"type":"null"}],"title":"Tool Choice"},"parallel_tool_calls":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Parallel Tool Calls"},"functions":{"anyOf":[{"items":{"$ref":"#/components/schemas/ChatFunctionDefinition"},"type":"array","maxItems":128,"minItems":1},{"type":"null"}],"title":"Functions"},"function_call":{"anyOf":[{"type":"string","enum":["none","auto"]},{"$ref":"#/components/schemas/ChatNamedFunctionChoice"},{"type":"null"}],"title":"Function Call"}},"type":"object","required":["model","messages"],"title":"ChatCompletionsRequest"},"ChatFunctionDefinition":{"properties":{"name":{"type":"string","maxLength":64,"minLength":1,"pattern":"^[A-Za-z0-9_-]+$","title":"Name"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"parameters":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Parameters"},"strict":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Strict"}},"additionalProperties":false,"type":"object","required":["name"],"title":"ChatFunctionDefinition"},"ChatFunctionTool":{"properties":{"type":{"type":"string","const":"function","title":"Type"},"function":{"$ref":"#/components/schemas/ChatFunctionDefinition"}},"additionalProperties":false,"type":"object","required":["type","function"],"title":"ChatFunctionTool"},"ChatMessage":{"properties":{"role":{"type":"string","title":"Role"},"content":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Content"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"},"tool_call_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Tool Call Id"},"tool_calls":{"anyOf":[{"items":{"$ref":"#/components/schemas/ChatMessageToolCall"},"type":"array"},{"type":"null"}],"title":"Tool Calls"},"function_call":{"anyOf":[{"$ref":"#/components/schemas/ChatMessageFunctionCall"},{"type":"null"}]}},"type":"object","required":["role"],"title":"ChatMessage"},"ChatMessageFunctionCall":{"properties":{"name":{"type":"string","title":"Name"},"arguments":{"type":"string","title":"Arguments"}},"additionalProperties":false,"type":"object","required":["name","arguments"],"title":"ChatMessageFunctionCall"},"ChatMessageToolCall":{"properties":{"id":{"type":"string","title":"Id"},"type":{"type":"string","const":"function","title":"Type"},"function":{"$ref":"#/components/schemas/ChatMessageFunctionCall"}},"additionalProperties":false,"type":"object","required":["id","type","function"],"title":"ChatMessageToolCall"},"ChatNamedFunctionChoice":{"properties":{"name":{"type":"string","maxLength":64,"minLength":1,"pattern":"^[A-Za-z0-9_-]+$","title":"Name"}},"additionalProperties":false,"type":"object","required":["name"],"title":"ChatNamedFunctionChoice"},"ChatNamedToolChoice":{"properties":{"type":{"type":"string","const":"function","title":"Type"},"function":{"$ref":"#/components/schemas/ChatNamedFunctionChoice"}},"additionalProperties":false,"type":"object","required":["type","function"],"title":"ChatNamedToolChoice"},"ClassifyRequest":{"properties":{"model":{"type":"string","title":"Model"},"input":{"anyOf":[{"type":"string"},{"items":{"type":"string"},"type":"array"}],"title":"Input"},"candidate_labels":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Candidate Labels"},"multi_label":{"type":"boolean","title":"Multi Label","default":false},"top_k":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Top K"},"hypothesis_template":{"type":"string","title":"Hypothesis Template","default":"This example is {}."},"task_hint":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Task Hint"}},"type":"object","required":["model","input"],"title":"ClassifyRequest"},"DeveloperCredentialCreateRequest":{"properties":{"name":{"type":"string","maxLength":80,"minLength":1,"title":"Name","description":"Human-readable label; never used as authentication material."},"scopes":{"items":{"type":"string"},"type":"array","maxItems":12,"minItems":1,"title":"Scopes","description":"Explicit least-privilege scopes granted to the new key."}},"additionalProperties":false,"type":"object","required":["name","scopes"],"title":"DeveloperCredentialCreateRequest"},"DeveloperCredentialListResponse":{"properties":{"data":{"items":{"$ref":"#/components/schemas/DeveloperCredentialMetadata"},"type":"array","title":"Data"},"next_cursor":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Next Cursor"}},"type":"object","required":["data"],"title":"DeveloperCredentialListResponse"},"DeveloperCredentialMetadata":{"properties":{"credential_id":{"type":"string","title":"Credential Id"},"name":{"type":"string","title":"Name"},"secret_prefix":{"type":"string","title":"Secret Prefix","description":"Non-secret prefix for identifying the key in logs and settings."},"scopes":{"items":{"type":"string"},"type":"array","title":"Scopes"},"version":{"type":"integer","title":"Version"},"billing_eligible":{"type":"boolean","title":"Billing Eligible"},"status":{"type":"string","enum":["active","revoked"],"title":"Status"},"created_at":{"type":"string","title":"Created At"},"updated_at":{"type":"string","title":"Updated At"},"rotated_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Rotated At"},"revoked_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Revoked At"}},"type":"object","required":["credential_id","name","secret_prefix","scopes","version","billing_eligible","status","created_at","updated_at"],"title":"DeveloperCredentialMetadata"},"DeveloperCredentialReceipt":{"properties":{"receipt_id":{"type":"string","title":"Receipt Id"},"action":{"type":"string","enum":["created","rotated","revoked"],"title":"Action"},"credential_id":{"type":"string","title":"Credential Id"},"credential_version":{"type":"integer","title":"Credential Version"},"detail":{"additionalProperties":true,"type":"object","title":"Detail"},"occurred_at":{"type":"string","title":"Occurred At"}},"type":"object","required":["receipt_id","action","credential_id","credential_version","detail","occurred_at"],"title":"DeveloperCredentialReceipt"},"DeveloperCredentialReceiptListResponse":{"properties":{"data":{"items":{"$ref":"#/components/schemas/DeveloperCredentialReceipt"},"type":"array","title":"Data"},"next_cursor":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Next Cursor"}},"type":"object","required":["data"],"title":"DeveloperCredentialReceiptListResponse"},"DeveloperCredentialRevokeResponse":{"properties":{"credential":{"$ref":"#/components/schemas/DeveloperCredentialMetadata"},"receipt":{"$ref":"#/components/schemas/DeveloperCredentialReceipt"},"already_revoked":{"type":"boolean","title":"Already Revoked"}},"type":"object","required":["credential","receipt","already_revoked"],"title":"DeveloperCredentialRevokeResponse"},"DeveloperCredentialSecretResponse":{"properties":{"credential":{"$ref":"#/components/schemas/DeveloperCredentialMetadata"},"secret":{"type":"string","title":"Secret","description":"One-time secret. Store it now: it is HMAC-hashed before persistence and cannot be listed or recovered later."},"receipt":{"$ref":"#/components/schemas/DeveloperCredentialReceipt"}},"type":"object","required":["credential","secret","receipt"],"title":"DeveloperCredentialSecretResponse"},"DiscoverRequest":{"properties":{"query":{"type":"string","title":"Query"},"kind":{"type":"string","title":"Kind","default":"any"},"limit":{"type":"integer","title":"Limit","default":10},"max_params_b":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Max Params B"},"require_mirrored":{"type":"boolean","title":"Require Mirrored","default":false}},"type":"object","required":["query"],"title":"DiscoverRequest"},"DocumentExtractRequest":{"properties":{"content":{"type":"string","maxLength":1406296,"minLength":1,"title":"Content","description":"Inline UTF-8 text or base64 document bytes, selected by content_encoding."},"mime_type":{"type":"string","enum":["application/vnd.openxmlformats-officedocument.wordprocessingml.document","text/html","text/markdown","text/csv","text/tab-separated-values"],"title":"Mime Type","description":"Canonical supported document MIME type."},"content_encoding":{"type":"string","enum":["utf-8","base64"],"title":"Content Encoding","default":"utf-8"},"filename":{"anyOf":[{"type":"string","maxLength":255,"minLength":1},{"type":"null"}],"title":"Filename","description":"Optional basename used to reject MIME/extension conflicts."},"max_chars":{"anyOf":[{"type":"integer","maximum":380000.0,"minimum":1.0},{"type":"null"}],"title":"Max Chars"},"max_rows":{"anyOf":[{"type":"integer","maximum":50000.0,"minimum":1.0},{"type":"null"}],"title":"Max Rows"},"has_header":{"type":"boolean","title":"Has Header","description":"CSV/TSV first-row header policy.","default":true}},"additionalProperties":false,"type":"object","required":["content","mime_type"],"title":"DocumentExtractRequest"},"EmbeddingsRequest":{"properties":{"model":{"type":"string","title":"Model"},"input":{"anyOf":[{"type":"string"},{"items":{"type":"string"},"type":"array"}],"title":"Input"},"task_hint":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Task Hint"}},"type":"object","required":["model","input"],"title":"EmbeddingsRequest"},"EvalRequest":{"properties":{"task":{"type":"string","title":"Task"},"models":{"items":{"type":"string"},"type":"array","title":"Models"},"dataset":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Dataset"},"k":{"type":"integer","title":"K","default":5}},"type":"object","required":["task","models","dataset"],"title":"EvalRequest"},"FeatureCatalogRequest":{"properties":{"title":{"type":"string","maxLength":120,"minLength":3,"title":"Title"},"description":{"type":"string","maxLength":2000,"minLength":10,"title":"Description"},"category":{"type":"string","enum":["catalog","mirroring","radar","api","serving","other"],"title":"Category","default":"other"},"contact":{"anyOf":[{"type":"string","maxLength":240},{"type":"null"}],"title":"Contact"}},"additionalProperties":false,"type":"object","required":["title","description"],"title":"FeatureCatalogRequest"},"FindSpecialistRequest":{"properties":{"task":{"type":"string","title":"Task"},"my_examples":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"My Examples"},"kind":{"type":"string","title":"Kind","default":"any"},"max_params_b":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Max Params B"},"n_candidates":{"type":"integer","title":"N Candidates","default":5},"k":{"type":"integer","title":"K","default":5}},"type":"object","required":["task","my_examples"],"title":"FindSpecialistRequest"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"JobItemRequest":{"properties":{"id":{"anyOf":[{"type":"string","maxLength":64,"minLength":1,"pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]*$"},{"type":"null"}],"title":"Id","description":"Caller correlation id; defaults to the zero-based item index."},"operation":{"type":"string","enum":["embeddings","rerank","classify","summarize","pdf_extract","calculate","validate_json","resolve_link"],"title":"Operation"},"arguments":{"additionalProperties":true,"type":"object","title":"Arguments"}},"additionalProperties":false,"type":"object","required":["operation","arguments"],"title":"JobItemRequest","description":"Shared typed item contract for both MCP discovery and REST/OpenAPI."},"MemoryContextRequest":{"properties":{"updates":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Updates","description":"Optional key->JSON updates to upsert atomically."},"namespace":{"type":"string","title":"Namespace","description":"Working-context namespace.","default":"default"},"delete_keys":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Delete Keys","description":"Optional keys to delete."},"ttl":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Ttl","description":"Optional TTL for every update."},"max_items":{"type":"integer","maximum":50.0,"minimum":1.0,"title":"Max Items","default":50},"max_bytes":{"type":"integer","maximum":131072.0,"minimum":256.0,"title":"Max Bytes","default":32768}},"additionalProperties":false,"type":"object","title":"MemoryContextRequest"},"MemoryToolResponse":{"properties":{"ok":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Ok"},"error":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Error"},"found":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Found"},"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Schema"},"namespace":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Namespace"},"key":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Key"},"query":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Query"},"value":{"title":"Value"},"count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Count"},"items":{"anyOf":[{"items":{"additionalProperties":true,"type":"object"},"type":"array"},{"type":"null"}],"title":"Items"},"context":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Context"},"receipts":{"anyOf":[{"additionalProperties":{"additionalProperties":true,"type":"object"},"type":"object"},{"type":"null"}],"title":"Receipts"},"has_more":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Has More"},"next_cursor":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Next Cursor"},"truncated":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Truncated"},"limit":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Limit"},"max_bytes":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Max Bytes"},"serialized_bytes":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Serialized Bytes"},"as_of":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"As Of"},"created_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Created At"},"updated_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Updated At"},"expires_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Expires At"},"expires_in":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Expires In"},"ttl_requested":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Ttl Requested"},"ttl_applied":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Ttl Applied"},"expired_pruned":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Expired Pruned"},"updated":{"anyOf":[{"type":"boolean"},{"type":"integer"},{"type":"null"}],"title":"Updated"},"deleted":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Deleted"},"entry_receipt":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Entry Receipt"},"receipt":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Receipt"}},"additionalProperties":true,"type":"object","title":"MemoryToolResponse","description":"Shared REST/MCP response envelope for every durable-memory operation.\n\nFields are optional because one model covers exact reads, pages, mutations,\nand typed in-band MCP errors. The serializer emits only fields supplied by\nthe store, preserving the established wire dictionaries byte-for-shape."},"MemoryTtlRequest":{"properties":{"namespace":{"type":"string","maxLength":256,"minLength":1,"title":"Namespace","description":"Namespace containing the live entry."},"key":{"type":"string","maxLength":512,"minLength":1,"title":"Key","description":"Key whose expiry should change without replacing its value."},"ttl":{"anyOf":[{"type":"integer","exclusiveMinimum":0.0},{"type":"null"}],"title":"Ttl","description":"Positive TTL seconds to set/refresh, or null to clear expiry."}},"additionalProperties":false,"type":"object","required":["namespace","key","ttl"],"title":"MemoryTtlRequest"},"MemoryWriteRequest":{"properties":{"namespace":{"type":"string","title":"Namespace","description":"Caller-chosen bucket (session/project/agent id)."},"key":{"type":"string","title":"Key","description":"Key to upsert."},"value":{"title":"Value","description":"JSON-serializable value (size-capped)."},"ttl":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Ttl","description":"Optional TTL in seconds; auto-expires."}},"additionalProperties":false,"type":"object","required":["namespace","key","value"],"title":"MemoryWriteRequest"},"MirrorCatalogRequest":{"properties":{"artifact_id":{"type":"string","maxLength":160,"minLength":2,"pattern":"^[A-Za-z0-9][A-Za-z0-9._-]+$","title":"Artifact Id"},"desired_files":{"anyOf":[{"items":{"type":"string","maxLength":260,"minLength":1},"type":"array","maxItems":20},{"type":"null"}],"title":"Desired Files"},"use_case":{"anyOf":[{"type":"string","maxLength":500},{"type":"null"}],"title":"Use Case"},"target_tool":{"anyOf":[{"type":"string","maxLength":120},{"type":"null"}],"title":"Target Tool"},"source_route":{"anyOf":[{"type":"string","maxLength":200},{"type":"null"}],"title":"Source Route"},"contact":{"anyOf":[{"type":"string","maxLength":240},{"type":"null"}],"title":"Contact"}},"additionalProperties":false,"type":"object","required":["artifact_id"],"title":"MirrorCatalogRequest"},"OpenSourceRadarResponse":{"properties":{"schema":{"type":"string","const":"bay-run.open-source-radar.v1","title":"Schema"},"generatedAt":{"type":"string","title":"Generatedat"},"sections":{"$ref":"#/components/schemas/RadarSectionsResponse"},"policy":{"$ref":"#/components/schemas/RadarPolicyResponse"}},"additionalProperties":false,"type":"object","required":["schema","generatedAt","sections","policy"],"title":"OpenSourceRadarResponse"},"PdfExtractRequest":{"properties":{"url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Url","description":"Public http(s) PDF URL."},"pdf_base64":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Pdf Base64","description":"Base64 bytes for a small PDF."},"start_page":{"type":"integer","minimum":1.0,"title":"Start Page","default":1},"max_pages":{"anyOf":[{"type":"integer","maximum":100.0,"minimum":1.0},{"type":"null"}],"title":"Max Pages"},"max_chars":{"anyOf":[{"type":"integer","maximum":400000.0,"minimum":1.0},{"type":"null"}],"title":"Max Chars"},"stream":{"type":"boolean","title":"Stream","default":false}},"additionalProperties":false,"type":"object","title":"PdfExtractRequest"},"RadarArtifactResponse":{"properties":{"id":{"type":"string","title":"Id"},"repo":{"type":"string","title":"Repo"},"type":{"type":"string","title":"Type"},"license":{"type":"string","title":"License"},"provider":{"type":"string","title":"Provider"},"downloads":{"type":"integer","minimum":0.0,"title":"Downloads"},"stars":{"type":"integer","minimum":0.0,"title":"Stars"},"hostingStatus":{"type":"string","title":"Hostingstatus"},"mirrored":{"type":"boolean","title":"Mirrored"},"updatedAt":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Updatedat"}},"additionalProperties":false,"type":"object","required":["id","repo","type","license","provider","downloads","stars","hostingStatus","mirrored","updatedAt"],"title":"RadarArtifactResponse"},"RadarPolicyResponse":{"properties":{"readOnly":{"type":"boolean","const":true,"title":"Readonly"},"publicOnly":{"type":"boolean","const":true,"title":"Publiconly"},"removedExcluded":{"type":"boolean","const":true,"title":"Removedexcluded"},"scanBlockedExcluded":{"type":"boolean","const":true,"title":"Scanblockedexcluded"},"requestIngestionQueuesWork":{"type":"boolean","const":false,"title":"Requestingestionqueueswork"}},"additionalProperties":false,"type":"object","required":["readOnly","publicOnly","removedExcluded","scanBlockedExcluded","requestIngestionQueuesWork"],"title":"RadarPolicyResponse"},"RadarSectionsResponse":{"properties":{"recent":{"items":{"$ref":"#/components/schemas/RadarArtifactResponse"},"type":"array","title":"Recent"},"popular":{"items":{"$ref":"#/components/schemas/RadarArtifactResponse"},"type":"array","title":"Popular"},"mirrored":{"items":{"$ref":"#/components/schemas/RadarArtifactResponse"},"type":"array","title":"Mirrored"}},"type":"object","required":["recent","popular","mirrored"],"title":"RadarSectionsResponse"},"RagRequest":{"properties":{"query":{"type":"string","title":"Query"},"documents":{"anyOf":[{"type":"string"},{"items":{"type":"string"},"type":"array"}],"title":"Documents"},"top_k":{"type":"integer","title":"Top K","default":3},"rerank":{"type":"boolean","title":"Rerank","default":true},"answer":{"type":"boolean","title":"Answer","default":false},"embedding_model":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Embedding Model"},"rerank_model":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Rerank Model"},"stream":{"type":"boolean","title":"Stream","default":false}},"type":"object","required":["query","documents"],"title":"RagRequest"},"RequestSpecialistRequest":{"properties":{"task":{"type":"string","title":"Task"},"examples":{"anyOf":[{"items":{"additionalProperties":true,"type":"object"},"type":"array"},{"type":"null"}],"title":"Examples"},"kind":{"type":"string","title":"Kind","default":"any"},"max_params_b":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Max Params B"},"n_candidates":{"type":"integer","title":"N Candidates","default":5},"k":{"type":"integer","title":"K","default":5}},"type":"object","required":["task"],"title":"RequestSpecialistRequest"},"RerankRequest":{"properties":{"model":{"type":"string","title":"Model"},"query":{"type":"string","title":"Query"},"documents":{"items":{"type":"string"},"type":"array","title":"Documents"},"top_n":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Top N"},"task_hint":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Task Hint"}},"type":"object","required":["model","query","documents"],"title":"RerankRequest"},"ResolveLinkRequest":{"properties":{"url":{"type":"string","title":"Url","description":"http(s) URL to check for liveness."}},"additionalProperties":false,"type":"object","required":["url"],"title":"ResolveLinkRequest"},"RouteRequest":{"properties":{"task_hint":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Task Hint"},"kind":{"type":"string","title":"Kind","default":"auto"},"input":{"anyOf":[{"type":"string"},{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Input"},"candidate_labels":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Candidate Labels"},"query":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Query"},"documents":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Documents"},"content":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Content"},"schema":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Schema"},"serve":{"type":"boolean","title":"Serve","default":false},"max_params_b":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Max Params B"}},"type":"object","title":"RouteRequest"},"SourceCatalogRequest":{"properties":{"source":{"anyOf":[{"type":"string","enum":["huggingface","modelscope","github","zenodo","arxiv"]},{"type":"null"}],"title":"Source"},"repo":{"anyOf":[{"type":"string","maxLength":500},{"type":"null"}],"title":"Repo"},"url":{"anyOf":[{"type":"string","maxLength":500},{"type":"null"}],"title":"Url"},"owner":{"anyOf":[{"type":"string","maxLength":160},{"type":"null"}],"title":"Owner"},"name":{"anyOf":[{"type":"string","maxLength":240},{"type":"null"}],"title":"Name"},"repo_type":{"anyOf":[{"type":"string","enum":["model","dataset","space","repository","record","paper"]},{"type":"null"}],"title":"Repo Type"},"use_case":{"anyOf":[{"type":"string","maxLength":500},{"type":"null"}],"title":"Use Case"},"target_tool":{"anyOf":[{"type":"string","maxLength":120},{"type":"null"}],"title":"Target Tool"},"contact":{"anyOf":[{"type":"string","maxLength":240},{"type":"null"}],"title":"Contact"}},"additionalProperties":false,"type":"object","title":"SourceCatalogRequest"},"StripeCheckoutRequest":{"properties":{"pack_code":{"type":"string","title":"Pack Code","default":"starter_1000"}},"additionalProperties":false,"type":"object","title":"StripeCheckoutRequest"},"StripeCreditUsageBalance":{"properties":{"available_credits":{"type":"integer","title":"Available Credits"},"reserved_credits":{"type":"integer","title":"Reserved Credits"},"status":{"type":"string","title":"Status"},"updated_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Updated At"}},"type":"object","required":["available_credits","reserved_credits","status","updated_at"],"title":"StripeCreditUsageBalance"},"StripeCreditUsagePage":{"properties":{"object":{"type":"string","const":"list","title":"Object"},"data":{"items":{"$ref":"#/components/schemas/StripeCreditUsageReceipt"},"type":"array","title":"Data"},"has_more":{"type":"boolean","title":"Has More"},"next_cursor":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Next Cursor"},"remaining_balance":{"$ref":"#/components/schemas/StripeCreditUsageBalance"},"credit_unit":{"type":"string","title":"Credit Unit"}},"type":"object","required":["object","data","has_more","next_cursor","remaining_balance","credit_unit"],"title":"StripeCreditUsagePage"},"StripeCreditUsageReceipt":{"properties":{"receipt_id":{"type":"string","title":"Receipt Id"},"usage_id":{"type":"string","title":"Usage Id"},"committed_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Committed At"},"credits_charged":{"type":"integer","title":"Credits Charged"},"remaining_credits":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Remaining Credits"},"served_model":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Served Model"},"total_tokens":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Total Tokens"}},"type":"object","required":["receipt_id","usage_id","committed_at","credits_charged","remaining_credits","served_model","total_tokens"],"title":"StripeCreditUsageReceipt"},"SummarizeRequest":{"properties":{"text":{"anyOf":[{"type":"string"},{"items":{"type":"string"},"type":"array"}],"title":"Text"},"max_sentences":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Max Sentences","default":5},"ratio":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Ratio"},"query":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Query"},"model":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Model"},"stream":{"type":"boolean","title":"Stream","default":false}},"type":"object","required":["text"],"title":"SummarizeRequest"},"ValidateJsonRequest":{"properties":{"data":{"title":"Data","description":"A JSON string to parse-check, or an object/array to schema-check."},"schema":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Schema","description":"Optional JSON Schema (Draft 2020-12)."}},"additionalProperties":false,"type":"object","required":["data"],"title":"ValidateJsonRequest"},"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"},"VerifyProvenanceRequest":{"properties":{"receipt":{"title":"Receipt","description":"Bay Run provenance_receipt object."},"output":{"title":"Output","description":"Optional result object for a semantic output-hash match; JSON null means omitted and is never echoed."},"source_artifacts":{"title":"Source Artifacts"},"document_chunks":{"title":"Document Chunks"},"citations":{"title":"Citations"}},"type":"object","title":"VerifyProvenanceRequest"},"MCPJsonRpcRequest":{"type":"object","required":["jsonrpc","method"],"properties":{"jsonrpc":{"type":"string","enum":["2.0"]},"id":{"oneOf":[{"type":"string"},{"type":"integer"},{"type":"null"}]},"method":{"type":"string"},"params":{"type":"object","additionalProperties":true}},"additionalProperties":true}},"securitySchemes":{"BearerAuth":{"type":"http","scheme":"bearer","description":"Bay Run OAuth access token or configured operator/demo bearer."},"DeveloperApiKey":{"type":"http","scheme":"bearer","bearerFormat":"bayr1.<credential_id>.<one-time-secret>","description":"OAuth-owned, revocable developer key. The raw secret is shown only on create/rotate and stored solely as a dedicated-pepper HMAC digest."}}},"servers":[{"url":"https://run.huggingbay.xyz"}],"x-service-info":{"categories":["compute","developer-tools","search"],"docs":{"homepage":"https://run.huggingbay.xyz","llms":"https://run.huggingbay.xyz/llms.txt","apiReference":"https://run.huggingbay.xyz/openapi.json","performance":"https://run.huggingbay.xyz/.well-known/performance.json","x402BuyerRecipes":"https://run.huggingbay.xyz/.well-known/x402/recipes"}},"x-discovery":{"canonical":{"serviceRoot":"https://run.huggingbay.xyz/","llms":"https://run.huggingbay.xyz/llms.txt","llmsFull":"https://run.huggingbay.xyz/llms-full.txt","robots":"https://run.huggingbay.xyz/robots.txt","sitemap":"https://run.huggingbay.xyz/sitemap.xml","mcpServerCard":"https://run.huggingbay.xyz/.well-known/mcp/server-card.json","mcpEndpoint":"https://run.huggingbay.xyz/mcp/","a2aAgentCard":"https://run.huggingbay.xyz/.well-known/agent-card.json","a2aEndpoint":"https://run.huggingbay.xyz/a2a","oauthProtectedResource":"https://run.huggingbay.xyz/.well-known/oauth-protected-resource","oauthAuthorizationServer":"https://run.huggingbay.xyz/.well-known/oauth-authorization-server"},"examples":{"mcpToolsList":{"method":"POST","url":"https://run.huggingbay.xyz/mcp/","body":{"jsonrpc":"2.0","id":1,"method":"tools/list"},"authentication":"none"},"a2aMessageSend":{"method":"POST","url":"https://run.huggingbay.xyz/a2a","body":{"jsonrpc":"2.0","id":"trial-1","method":"message/send","params":{"message":{"messageId":"trial-message-1","role":"user","parts":[{"kind":"text","text":"Try Bay Run"}]}}},"authentication":"none"}}}}