Generated API Reference
Generated from SynapseX service OpenAPI specs. Fern/generated clients should use these contracts as source of truth.Services
| Service | Version | Paths | Schemas |
|---|---|---|---|
api-gateway | 1.0.0 | 41 | 8 |
billing-service | 1.0.0 | 58 | 22 |
llm-router-service | 1.0.0 | 10 | 13 |
mcp-router-service | 1.0.0 | 16 | 6 |
research-mcp-service | 0.1.0 | 3 | 0 |
Endpoints
api-gateway
| Method | Path | Tags | Summary | Operation ID |
|---|---|---|---|---|
GET | /health | Health | health_health_get | |
GET | /v1/agents | List Agents | list_agents_v1_agents_get | |
POST | /v1/agents | Create Agent | create_agent_v1_agents_post | |
GET | /v1/agents/jobs | Proxy Agent Jobs | proxy_agent_jobs_v1_agents_jobs_get | |
POST | /v1/agents/jobs | Proxy Agent Jobs | proxy_agent_jobs_v1_agents_jobs_get | |
DELETE | /v1/agents/jobs/{job_path} | Proxy Agent Job Path | proxy_agent_job_path_v1_agents_jobs__job_path__patch | |
GET | /v1/agents/jobs/{job_path} | Proxy Agent Job Path | proxy_agent_job_path_v1_agents_jobs__job_path__patch | |
PATCH | /v1/agents/jobs/{job_path} | Proxy Agent Job Path | proxy_agent_job_path_v1_agents_jobs__job_path__patch | |
POST | /v1/agents/jobs/{job_path} | Proxy Agent Job Path | proxy_agent_job_path_v1_agents_jobs__job_path__patch | |
PUT | /v1/agents/jobs/{job_path} | Proxy Agent Job Path | proxy_agent_job_path_v1_agents_jobs__job_path__patch | |
GET | /v1/agents/profiles | List Agent Profiles | list_agent_profiles_v1_agents_profiles_get | |
DELETE | /v1/agents/{agent_id} | Delete Agent | delete_agent_v1_agents__agent_id__delete | |
GET | /v1/agents/{agent_id} | Get Agent | get_agent_v1_agents__agent_id__get | |
PUT | /v1/agents/{agent_id} | Update Agent | update_agent_v1_agents__agent_id__put | |
POST | /v1/agents/{agent_id}/deploy | Deploy Agent | deploy_agent_v1_agents__agent_id__deploy_post | |
POST | /v1/agents/{agent_id}/invoke | Invoke Agent | invoke_agent_v1_agents__agent_id__invoke_post | |
GET | /v1/agents/{agent_id}/logs | Get Agent Logs | get_agent_logs_v1_agents__agent_id__logs_get | |
POST | /v1/auth/google/callback | Google Callback | google_callback_v1_auth_google_callback_post | |
GET | /v1/auth/google/start | Google Auth Start | google_auth_start_v1_auth_google_start_get | |
GET | /v1/auth/keys | Proxy Auth Keys | proxy_auth_keys_v1_auth_keys_get | |
POST | /v1/auth/keys | Proxy Auth Keys | proxy_auth_keys_v1_auth_keys_get | |
DELETE | /v1/auth/keys/{key_id} | Proxy Auth Key | proxy_auth_key_v1_auth_keys__key_id__delete | |
GET | /v1/auth/keys/{key_id} | Proxy Auth Key | proxy_auth_key_v1_auth_keys__key_id__delete | |
POST | /v1/auth/login | Login | login_v1_auth_login_post | |
GET | /v1/auth/me | Me | me_v1_auth_me_get | |
POST | /v1/auth/register | Register | register_v1_auth_register_post | |
DELETE | /v1/billing/{billing_path} | Proxy Billing | proxy_billing_v1_billing__billing_path__patch | |
GET | /v1/billing/{billing_path} | Proxy Billing | proxy_billing_v1_billing__billing_path__patch | |
PATCH | /v1/billing/{billing_path} | Proxy Billing | proxy_billing_v1_billing__billing_path__patch | |
POST | /v1/billing/{billing_path} | Proxy Billing | proxy_billing_v1_billing__billing_path__patch | |
PUT | /v1/billing/{billing_path} | Proxy Billing | proxy_billing_v1_billing__billing_path__patch | |
POST | /v1/chat/completions | Proxy Chat Completions | proxy_chat_completions_v1_chat_completions_post | |
GET | /v1/events | Proxy Events Root | proxy_events_root_v1_events_get | |
POST | /v1/events | Proxy Events Root | proxy_events_root_v1_events_get | |
DELETE | /v1/events/{event_path} | Proxy Events | proxy_events_v1_events__event_path__patch | |
GET | /v1/events/{event_path} | Proxy Events | proxy_events_v1_events__event_path__patch | |
PATCH | /v1/events/{event_path} | Proxy Events | proxy_events_v1_events__event_path__patch | |
POST | /v1/events/{event_path} | Proxy Events | proxy_events_v1_events__event_path__patch | |
POST | /v1/mcp/ask | Proxy Mcp Ask | proxy_mcp_ask_v1_mcp_ask_post | |
POST | /v1/mcp/execute | Proxy Mcp Execute | proxy_mcp_execute_v1_mcp_execute_post | |
POST | /v1/mcp/plan | Proxy Mcp Plan | proxy_mcp_plan_v1_mcp_plan_post | |
GET | /v1/mcp/plans | Proxy Mcp Plans | proxy_mcp_plans_v1_mcp_plans_get | |
POST | /v1/mcp/route | Proxy Mcp Route | proxy_mcp_route_v1_mcp_route_post | |
GET | /v1/mcp/router/tools | Proxy Mcp Router Tools | proxy_mcp_router_tools_v1_mcp_router_tools_get | |
GET | /v1/mcp/servers | Proxy Mcp Servers | proxy_mcp_servers_v1_mcp_servers_get | |
POST | /v1/mcp/servers | Proxy Mcp Servers | proxy_mcp_servers_v1_mcp_servers_get | |
GET | /v1/mcp/tools | List Mcp Tools | list_mcp_tools_v1_mcp_tools_get | |
POST | /v1/mcp/tools/execute | Execute Mcp Tool | execute_mcp_tool_v1_mcp_tools_execute_post | |
GET | /v1/mcp/tools/{name} | Get Mcp Tool | get_mcp_tool_v1_mcp_tools__name__get | |
GET | /v1/model-registry/models | Proxy Model Registry Root | proxy_model_registry_root_v1_model_registry_models_get | |
POST | /v1/model-registry/models | Proxy Model Registry Root | proxy_model_registry_root_v1_model_registry_models_get | |
DELETE | /v1/model-registry/models/{model_path} | Proxy Model Registry | proxy_model_registry_v1_model_registry_models__model_path__patch | |
GET | /v1/model-registry/models/{model_path} | Proxy Model Registry | proxy_model_registry_v1_model_registry_models__model_path__patch | |
PATCH | /v1/model-registry/models/{model_path} | Proxy Model Registry | proxy_model_registry_v1_model_registry_models__model_path__patch | |
POST | /v1/model-registry/models/{model_path} | Proxy Model Registry | proxy_model_registry_v1_model_registry_models__model_path__patch | |
GET | /v1/models | Proxy Models | proxy_models_v1_models_get | |
GET | /v1/telemetry/{telemetry_path} | Proxy Telemetry | proxy_telemetry_v1_telemetry__telemetry_path__get | |
POST | /v1/telemetry/{telemetry_path} | Proxy Telemetry | proxy_telemetry_v1_telemetry__telemetry_path__get | |
GET | /v1/tenants | Proxy Tenants Root | proxy_tenants_root_v1_tenants_get | |
POST | /v1/tenants | Proxy Tenants Root | proxy_tenants_root_v1_tenants_get | |
DELETE | /v1/tenants/{tenant_path} | Proxy Tenants | proxy_tenants_v1_tenants__tenant_path__patch | |
GET | /v1/tenants/{tenant_path} | Proxy Tenants | proxy_tenants_v1_tenants__tenant_path__patch | |
PATCH | /v1/tenants/{tenant_path} | Proxy Tenants | proxy_tenants_v1_tenants__tenant_path__patch | |
POST | /v1/tenants/{tenant_path} | Proxy Tenants | proxy_tenants_v1_tenants__tenant_path__patch | |
DELETE | /v1/updates/{update_path} | Proxy Updates | proxy_updates_v1_updates__update_path__patch | |
GET | /v1/updates/{update_path} | Proxy Updates | proxy_updates_v1_updates__update_path__patch | |
PATCH | /v1/updates/{update_path} | Proxy Updates | proxy_updates_v1_updates__update_path__patch | |
POST | /v1/updates/{update_path} | Proxy Updates | proxy_updates_v1_updates__update_path__patch | |
DELETE | /v1/usage/{usage_path} | Proxy Usage | proxy_usage_v1_usage__usage_path__patch | |
GET | /v1/usage/{usage_path} | Proxy Usage | proxy_usage_v1_usage__usage_path__patch | |
PATCH | /v1/usage/{usage_path} | Proxy Usage | proxy_usage_v1_usage__usage_path__patch | |
POST | /v1/usage/{usage_path} | Proxy Usage | proxy_usage_v1_usage__usage_path__patch | |
PUT | /v1/usage/{usage_path} | Proxy Usage | proxy_usage_v1_usage__usage_path__patch | |
DELETE | /v1/webhooks/{webhook_path} | Proxy Webhooks | proxy_webhooks_v1_webhooks__webhook_path__patch | |
GET | /v1/webhooks/{webhook_path} | Proxy Webhooks | proxy_webhooks_v1_webhooks__webhook_path__patch | |
PATCH | /v1/webhooks/{webhook_path} | Proxy Webhooks | proxy_webhooks_v1_webhooks__webhook_path__patch | |
POST | /v1/webhooks/{webhook_path} | Proxy Webhooks | proxy_webhooks_v1_webhooks__webhook_path__patch | |
GET | /v1/workspaces | Proxy Workspaces Root | proxy_workspaces_root_v1_workspaces_get | |
POST | /v1/workspaces | Proxy Workspaces Root | proxy_workspaces_root_v1_workspaces_get | |
DELETE | /v1/workspaces/{workspace_path} | Proxy Workspaces | proxy_workspaces_v1_workspaces__workspace_path__patch | |
GET | /v1/workspaces/{workspace_path} | Proxy Workspaces | proxy_workspaces_v1_workspaces__workspace_path__patch | |
PATCH | /v1/workspaces/{workspace_path} | Proxy Workspaces | proxy_workspaces_v1_workspaces__workspace_path__patch | |
POST | /v1/workspaces/{workspace_path} | Proxy Workspaces | proxy_workspaces_v1_workspaces__workspace_path__patch |
billing-service
| Method | Path | Tags | Summary | Operation ID |
|---|---|---|---|---|
GET | /health | Health | health_health_get | |
GET | /v1/agents/pricing | Get Agent Pricing | get_agent_pricing_v1_agents_pricing_get | |
GET | /v1/credits/me | Get My Credits | get_my_credits_v1_credits_me_get | |
GET | /v1/credits/me/ledger | Get My Credits Ledger | get_my_credits_ledger_v1_credits_me_ledger_get | |
GET | /v1/credits/packages | Get Credit Packages | get_credit_packages_v1_credits_packages_get | |
GET | /v1/credits/{tenant_id} | Get Credits | get_credits_v1_credits__tenant_id__get | |
POST | /v1/credits/{tenant_id}/buy | Buy Credits | buy_credits_v1_credits__tenant_id__buy_post | |
GET | /v1/credits/{tenant_id}/ledger | Get Credits Ledger | get_credits_ledger_v1_credits__tenant_id__ledger_get | |
GET | /v1/gateway/models | List Gateway Models | list_gateway_models_v1_gateway_models_get | |
GET | /v1/gateway/models/{tier} | List Models By Tier | list_models_by_tier_v1_gateway_models__tier__get | |
GET | /v1/gateway/providers | List Gateway Providers | list_gateway_providers_v1_gateway_providers_get | |
GET | /v1/invoices/{tenant_id} | List Invoices | list_invoices_v1_invoices__tenant_id__get | |
GET | /v1/limits/{tenant_id} | Check Limits | check_limits_v1_limits__tenant_id__get | |
POST | /v1/meters/agents/report | Report Agent Meter Usage | report_agent_meter_usage_v1_meters_agents_report_post | |
POST | /v1/meters/llm/report | Report Llm Meter Usage | report_llm_meter_usage_v1_meters_llm_report_post | |
POST | /v1/meters/report | Report Llm Usage | report_llm_usage_v1_meters_report_post | |
GET | /v1/plans | List Plans | list_plans_v1_plans_get | |
GET | /v1/plans/agents | List Agent Plans | list_agent_plans_v1_plans_agents_get | |
GET | /v1/plans/agents/metadata | Get Agent Plans Metadata | get_agent_plans_metadata_v1_plans_agents_metadata_get | |
GET | /v1/plans/api | List Api Plans | list_api_plans_v1_plans_api_get | |
GET | /v1/plans/chat | List Chat Plans | list_chat_plans_v1_plans_chat_get | |
GET | /v1/plans/chat/metadata | Get Chat Plans Metadata | get_chat_plans_metadata_v1_plans_chat_metadata_get | |
GET | /v1/plans/llm | List Llm Plans | list_llm_plans_v1_plans_llm_get | |
GET | /v1/subscription/agents/{tenant_id} | Get Agent Subscription | get_agent_subscription_v1_subscription_agents__tenant_id__get | |
POST | /v1/subscription/agents/{tenant_id}/checkout | Create Agent Checkout | create_agent_checkout_v1_subscription_agents__tenant_id__checkout_post | |
POST | /v1/subscription/agents/{tenant_id}/update-plan | Update Agent Plan | update_agent_plan_v1_subscription_agents__tenant_id__update_plan_post | |
GET | /v1/subscription/chat/{tenant_id} | Get Chat Subscription | get_chat_subscription_v1_subscription_chat__tenant_id__get | |
POST | /v1/subscription/chat/{tenant_id}/checkout | Create Chat Checkout | create_chat_checkout_v1_subscription_chat__tenant_id__checkout_post | |
POST | /v1/subscription/chat/{tenant_id}/update-plan | Update Chat Plan | update_chat_plan_v1_subscription_chat__tenant_id__update_plan_post | |
POST | /v1/subscription/checkout | Create Checkout Session | create_checkout_session_v1_subscription_checkout_post | |
GET | /v1/subscription/me/agents | Get My Agent Subscription | get_my_agent_subscription_v1_subscription_me_agents_get | |
POST | /v1/subscription/me/agents/checkout | Create My Agent Checkout | create_my_agent_checkout_v1_subscription_me_agents_checkout_post | |
GET | /v1/subscription/me/api | Get My Api Subscription | get_my_api_subscription_v1_subscription_me_api_get | |
POST | /v1/subscription/me/api/checkout | Create Api Checkout | create_api_checkout_v1_subscription_me_api_checkout_post | |
GET | /v1/subscription/me/chat | Get My Chat Subscription | get_my_chat_subscription_v1_subscription_me_chat_get | |
POST | /v1/subscription/me/chat/checkout | Create My Chat Checkout | create_my_chat_checkout_v1_subscription_me_chat_checkout_post | |
GET | /v1/subscription/me/llm | Get My Llm Subscription | get_my_llm_subscription_v1_subscription_me_llm_get | |
POST | /v1/subscription/me/llm/checkout | Create Llm Checkout | create_llm_checkout_v1_subscription_me_llm_checkout_post | |
GET | /v1/subscription/{tenant_id} | Get Subscription | get_subscription_v1_subscription__tenant_id__get | |
POST | /v1/subscription/{tenant_id}/cancel | Cancel Subscription | cancel_subscription_v1_subscription__tenant_id__cancel_post | |
GET | /v1/subscription/{tenant_id}/portal | Billing Portal | billing_portal_v1_subscription__tenant_id__portal_get | |
POST | /v1/subscription/{tenant_id}/update-plan | Update Plan | update_plan_v1_subscription__tenant_id__update_plan_post | |
POST | /v1/usage/agents/report | Report Agent Usage | report_agent_usage_v1_usage_agents_report_post | |
POST | /v1/usage/chat/report | Report Chat Usage | report_chat_usage_v1_usage_chat_report_post | |
GET | /v1/usage/me | My Llm Usage | my_llm_usage_v1_usage_me_get | |
GET | /v1/usage/me/agents | My Agent Usage | my_agent_usage_v1_usage_me_agents_get | |
GET | /v1/usage/me/api | Get My Api Usage | get_my_api_usage_v1_usage_me_api_get | |
GET | /v1/usage/me/chat | My Chat Usage | my_chat_usage_v1_usage_me_chat_get | |
GET | /v1/usage/me/llm | Get My Llm Usage | get_my_llm_usage_v1_usage_me_llm_get | |
GET | /v1/usage/me/quota | My Quota | my_quota_v1_usage_me_quota_get | |
GET | /v1/usage/me/summary | My Usage Summary | my_usage_summary_v1_usage_me_summary_get | |
GET | /v1/usage/{tenant_id} | Get Usage | get_usage_v1_usage__tenant_id__get | |
GET | /v1/usage/{tenant_id}/agents | Get Agent Usage | get_agent_usage_v1_usage__tenant_id__agents_get | |
GET | /v1/usage/{tenant_id}/chat | Get Chat Usage | get_chat_usage_v1_usage__tenant_id__chat_get | |
GET | /v1/usage/{tenant_id}/llm-summary | Llm Usage Summary | llm_usage_summary_v1_usage__tenant_id__llm_summary_get | |
POST | /v1/usage/{tenant_id}/record | Record Usage | record_usage_v1_usage__tenant_id__record_post | |
GET | /v1/usage/{tenant_id}/summary | Get Usage Summary | get_usage_summary_v1_usage__tenant_id__summary_get | |
POST | /v1/webhook/stripe | Stripe Webhook | stripe_webhook_v1_webhook_stripe_post |
llm-router-service
| Method | Path | Tags | Summary | Operation ID |
|---|---|---|---|---|
GET | /health | Health | health_health_get | |
GET | /v1 | V1 Root | v1_root_v1_get | |
POST | /v1/chat | Chat | chat_v1_chat_post | |
POST | /v1/chat/completions | Openai Chat Completions | openai_chat_completions_v1_chat_completions_post | |
POST | /v1/cost-estimate | Cost Estimate | cost_estimate_v1_cost_estimate_post | |
POST | /v1/messages | Anthropic Messages | anthropic_messages_v1_messages_post | |
GET | /v1/models | List Models | list_models_v1_models_get | |
GET | /v1/providers/health | Providers Health | providers_health_v1_providers_health_get | |
GET | /v1/usage/me | Get My Usage | get_my_usage_v1_usage_me_get | |
GET | /v1/usage/me/quota | Get My Quota | get_my_quota_v1_usage_me_quota_get |
mcp-router-service
| Method | Path | Tags | Summary | Operation ID |
|---|---|---|---|---|
GET | /health | Health | health_health_get | |
POST | /mcp/ask | Ask | ask_mcp_ask_post | |
POST | /mcp/execute | Execute | execute_mcp_execute_post | |
POST | /mcp/plan | Plan | plan_mcp_plan_post | |
GET | /mcp/plans | List Plans | list_plans_mcp_plans_get | |
POST | /mcp/route | Route | route_mcp_route_post | |
GET | /mcp/router/tools | List Routable Tools | list_routable_tools_mcp_router_tools_get | |
GET | /mcp/servers | List Servers | list_servers_mcp_servers_get | |
POST | /mcp/servers | Upsert Server | upsert_server_mcp_servers_post | |
GET | /mcp/tools | List Routable Tools | list_routable_tools_mcp_tools_get | |
POST | /v1/mcp/ask | Ask | ask_v1_mcp_ask_post | |
POST | /v1/mcp/execute | Execute | execute_v1_mcp_execute_post | |
POST | /v1/mcp/plan | Plan | plan_v1_mcp_plan_post | |
GET | /v1/mcp/plans | List Plans | list_plans_v1_mcp_plans_get | |
POST | /v1/mcp/route | Route | route_v1_mcp_route_post | |
GET | /v1/mcp/router/tools | List Routable Tools | list_routable_tools_v1_mcp_router_tools_get | |
GET | /v1/mcp/servers | List Servers | list_servers_v1_mcp_servers_get | |
POST | /v1/mcp/servers | Upsert Server | upsert_server_v1_mcp_servers_post |
research-mcp-service
| Method | Path | Tags | Summary | Operation ID |
|---|---|---|---|---|
GET | /health | Health | health_health_get | |
GET | /ready | Ready | ready_ready_get | |
GET | /v1/research-mcp/tools | Tools | tools_v1_research_mcp_tools_get |