Manage AI service connections in OmniRoute through its API. Add, update, remove, and test connections, maintain API keys and sign-in credentials, and inspect usage metrics and connection health.
Manage provider connections, API keys, OAuth flows, and connection tests via the REST API. List, add, update, remove, and test AI provider integrations across OmniRoute's 375-provider catalog.
Review the instructions the agent will receive before you install.
Manage provider connections, API keys, OAuth flows, and connection tests via the REST API. List, add, update, remove, and test AI provider integrations across OmniRoute's 375-provider catalog.
All requests require a valid Bearer token or session cookie. Obtain a token via POST /api/auth/login or configure REQUIRE_API_KEY=false for local development.
GET /api/providersPOST /api/providersGET /api/providers/{id}PATCH /api/providers/{id}DELETE /api/providers/{id}POST /api/providers/{id}/testGET /api/providers/{id}/test-messagePOST /api/providers/{id}/test-messagePUT /api/providers/{id}/test-messageGET /api/providers/{id}/modelsGET /api/providers/cursor/agent-availabilityPOST /api/providers/test-batchPOST /api/providers/validateGET /api/providers/clientPOST /api/providers/agy-auth/importPOST /api/providers/agy-auth/import-bulkPOST /api/providers/agy-auth/zip-extractPOST /api/providers/agy-auth/apply-localGET /api/provider-nodesPOST /api/provider-nodesPATCH /api/provider-nodes/{id}DELETE /api/provider-nodes/{id}POST /api/provider-nodes/validateGET /api/provider-modelsPUT /api/provider-modelsPOST /api/provider-models/validate-and-addGET /api/providers/{id}/cc-aliasPUT /api/providers/{id}/cc-aliasGET /api/providers/{id}/chatgpt-web-codex-doctorPOST /api/providers/{id}/claude-auth/apply-localPOST /api/providers/{id}/claude-auth/exportPOST /api/providers/{id}/codex-auth/apply-localPOST /api/providers/{id}/codex-auth/exportGET /api/providers/{id}/interception-rulesPUT /api/providers/{id}/interception-rulesDELETE /api/providers/{id}/interception-rulesPOST /api/providers/{id}/loginGET /api/providers/{id}/param-filtersPUT /api/providers/{id}/param-filtersDELETE /api/providers/{id}/param-filtersPOST /api/providers/{id}/refreshPOST /api/providers/{id}/refresh-cursorPOST /api/providers/{id}/refresh-tokenPOST /api/providers/{id}/sync-modelsPOST /api/providers/bulkPOST /api/providers/bulk-web-sessionPOST /api/providers/claude-auth/importPOST /api/providers/claude-auth/import-bulkPOST /api/providers/claude-auth/zip-extractPOST /api/providers/codex-auth/importPOST /api/providers/codex-auth/import-bulkPOST /api/providers/codex-auth/zip-extractPOST /api/providers/command-code/auth/applyPOST /api/providers/command-code/auth/callbackPOST /api/providers/command-code/auth/startGET /api/providers/command-code/auth/statusPOST /api/providers/command-code/auth/statusGET /api/providers/expirationGET /api/providers/free-onboardingPOST /api/providers/free-onboardingGET /api/providers/health-autopilotPOST /api/providers/health-autopilot/actionsGET /api/providers/health-matrixPOST /api/providers/importGET /api/providers/openrouter-statsGET /api/providers/quota-windowsPOST /api/providers/volcengine-plan/connectPOST /api/providers/volcengine-plan/connect/{sessionId}/cancelPOST /api/providers/volcengine-plan/connect/{sessionId}/codePOST /api/providers/volcengine-plan/connect/{sessionId}/identityPOST /api/providers/volcengine-plan/connect/{sessionId}/resendGET /api/providers/volcengine-plan/connect/{sessionId}/statusGET /api/providers/web-session-contractPOST /api/providers/zed/discoverPOST /api/providers/zed/importPOST /api/providers/zed/manual-importSee the full OpenAPI specification at GET /api/openapi/spec or docs/openapi.yaml for detailed request/response schemas.
Rotate / refresh OAuth tokens or re-validate credentials for a provider connection. Useful after token expiration or when credentials need to be renewed without deleting the connection.
curl -X POST https://localhost:20128/api/providers/{id}/refresh \
-H "Authorization: Bearer $OMNIROUTE_TOKEN" \
-H "Content-Type: application/json" \
-d '{}'
Retrieve aggregated usage and performance metrics for all provider connections (request counts, error rates, latency percentiles, token usage). Used by dashboards and Auto-Combo scoring.
curl https://localhost:20128/api/provider-metrics \
-H "Authorization: Bearer $OMNIROUTE_TOKEN"
Response example:
{
"providers": [
{
"id": "my-openai",
"requestCount": 1240,
"errorRate": 0.02,
"p50LatencyMs": 340,
"p99LatencyMs": 1200,
"tokensIn": 500000,
"tokensOut": 250000
}
]
}
Returns a health-matrix view of all providers with per-connection status, circuit-breaker state, and cooldown expiry. Useful for debugging routing decisions.
curl https://localhost:20128/api/providers/health-matrix \
-H "Authorization: Bearer $OMNIROUTE_TOKEN"
No reviews yet. Tell others what you thought.
No login needed. Share how it worked for you, ask a question, or note where it did not run.
No comments yet. Be the first to write one.
Use the command line to send tasks to OmniRoute's A2A server, which supports communication between agents. Inspect execution history and logs, monitor or cancel tasks, and interactively test the JSON-RPC 2.0 communication protocol.
Back up and restore OmniRoute data from the command line. Manage incremental snapshots, scheduled backups, encryption, and cloud synchronization, with options to compare differences and preview data transfers or imports before applying them.
Submit groups of AI requests as batch jobs with the OmniRoute command line. Manage input files, monitor or cancel jobs, save results and errors, and incorporate batch processing into automated build and deployment workflows.
Send prompts to LLMs from a terminal, display answers as they arrive, or hold an ongoing conversation. Use files or standard input for prompts, choose models, and set system instructions through OmniRoute.
Configure prompt compression, which shortens text sent to AI models, through the OmniRoute command line. Adjust RTK filters, Caveman rules, and combined compression modes, then preview the results using real prompts.
Manage OmniRoute context settings from the command line, including token budgets and RTK filters for processing context. Switch saved server connections, import or export configurations, and inspect or expire conversation sessions.