@volter/twin-openrouter 0.1.0

package/test-fixtures/openrouter-openapi-operations.json

@@ -0,0 +1,1041 @@
+{
+  "openapi": "3.0.3",
+  "info": {
+    "title": "OpenRouter API (spec-census scoped subset)",
+    "version": "1.0.0",
+    "description": "A scope-filtered SUBSET of the upstream spec (https://openrouter.ai/openapi.json), derived by scripts/spec-census-bootstrap.ts: every operation under the committed scopePaths, operation metadata only (operationId, summary, tags, servers) \u2014 schemas AND response codes dropped, which makes this an operation INVENTORY in OpenAPI's shape rather than a valid OpenAPI document: it says which operations exist and nothing about what they answer. It carried the FIRST response code per operation, which reads as the whole set \u2014 diff status codes against the freshly fetched spec instead. It is ONLY the operation-inventory denominator for ../openrouter-spec-census.json; see openrouter-openapi-operations.SOURCE.md for provenance."
+  },
+  "servers": [
+    {
+      "description": "Production server",
+      "url": "https://openrouter.ai/api/v1",
+      "x-speakeasy-server-id": "production"
+    }
+  ],
+  "x-source": {
+    "vendor": "openrouter",
+    "upstream": "https://openrouter.ai/openapi.json",
+    "upstreamFile": "openapi.json",
+    "vendored": "derived by scripts/spec-census-bootstrap.ts from openapi.json fetched 2026-09-02 \u2014 scope-filtered to scopePaths, schemas and response codes dropped",
+    "curatedOn": "2026-09-02",
+    "scope": "/analytics, /audio, /auth, /byok, /chat/, /credits, /datasets, /embeddings, /files, /generation, /guardrails, /key, /messages, /models, /observability/destinations, /organization/members, /presets, /providers, /rerank, /responses, /videos, /workspaces"
+  },
+  "paths": {
+    "/analytics/meta": {
+      "servers": [
+        {
+          "url": "https://openrouter.ai/api/v1"
+        }
+      ],
+      "get": {
+        "operationId": "getAnalyticsMeta",
+        "summary": "Get available analytics metrics and dimensions",
+        "tags": [
+          "Analytics"
+        ]
+      }
+    },
+    "/analytics/query": {
+      "servers": [
+        {
+          "url": "https://openrouter.ai/api/v1"
+        }
+      ],
+      "post": {
+        "operationId": "queryAnalytics",
+        "summary": "Query analytics data",
+        "tags": [
+          "Analytics"
+        ]
+      }
+    },
+    "/audio/speech": {
+      "servers": [
+        {
+          "url": "https://openrouter.ai/api/v1"
+        }
+      ],
+      "post": {
+        "operationId": "createAudioSpeech",
+        "summary": "Create speech",
+        "tags": [
+          "TTS"
+        ]
+      }
+    },
+    "/audio/transcriptions": {
+      "servers": [
+        {
+          "url": "https://openrouter.ai/api/v1"
+        }
+      ],
+      "post": {
+        "operationId": "createAudioTranscriptions",
+        "summary": "Create transcription",
+        "tags": [
+          "STT"
+        ]
+      }
+    },
+    "/auth/keys": {
+      "servers": [
+        {
+          "url": "https://openrouter.ai/api/v1"
+        }
+      ],
+      "post": {
+        "operationId": "exchangeAuthCodeForAPIKey",
+        "summary": "Exchange authorization code for API key",
+        "tags": [
+          "OAuth"
+        ]
+      }
+    },
+    "/auth/keys/code": {
+      "servers": [
+        {
+          "url": "https://openrouter.ai/api/v1"
+        }
+      ],
+      "post": {
+        "operationId": "createAuthKeysCode",
+        "summary": "Create authorization code",
+        "tags": [
+          "OAuth"
+        ]
+      }
+    },
+    "/byok": {
+      "servers": [
+        {
+          "url": "https://openrouter.ai/api/v1"
+        }
+      ],
+      "get": {
+        "operationId": "listBYOKKeys",
+        "summary": "List BYOK provider credentials",
+        "tags": [
+          "BYOK"
+        ]
+      },
+      "post": {
+        "operationId": "createBYOKKey",
+        "summary": "Create a BYOK provider credential",
+        "tags": [
+          "BYOK"
+        ]
+      }
+    },
+    "/byok/{id}": {
+      "servers": [
+        {
+          "url": "https://openrouter.ai/api/v1"
+        }
+      ],
+      "delete": {
+        "operationId": "deleteBYOKKey",
+        "summary": "Delete a BYOK provider credential",
+        "tags": [
+          "BYOK"
+        ]
+      },
+      "get": {
+        "operationId": "getBYOKKey",
+        "summary": "Get a BYOK provider credential",
+        "tags": [
+          "BYOK"
+        ]
+      },
+      "patch": {
+        "operationId": "updateBYOKKey",
+        "summary": "Update a BYOK provider credential",
+        "tags": [
+          "BYOK"
+        ]
+      }
+    },
+    "/chat/completions": {
+      "servers": [
+        {
+          "url": "https://openrouter.ai/api/v1"
+        }
+      ],
+      "post": {
+        "operationId": "sendChatCompletionRequest",
+        "summary": "Create a chat completion",
+        "tags": [
+          "Chat"
+        ]
+      }
+    },
+    "/credits": {
+      "servers": [
+        {
+          "url": "https://openrouter.ai/api/v1"
+        }
+      ],
+      "get": {
+        "operationId": "getCredits",
+        "summary": "Get remaining credits",
+        "tags": [
+          "Credits"
+        ]
+      }
+    },
+    "/credits/coinbase": {
+      "servers": [
+        {
+          "url": "https://openrouter.ai/api/v1"
+        }
+      ],
+      "post": {
+        "operationId": "createCoinbaseCharge",
+        "summary": "Deprecated Coinbase Commerce charge endpoint",
+        "tags": [
+          "Credits"
+        ]
+      }
+    },
+    "/datasets/app-rankings": {
+      "servers": [
+        {
+          "url": "https://openrouter.ai/api/v1"
+        }
+      ],
+      "get": {
+        "operationId": "getAppRankings",
+        "summary": "Top apps by token usage",
+        "tags": [
+          "Datasets"
+        ]
+      }
+    },
+    "/datasets/rankings-daily": {
+      "servers": [
+        {
+          "url": "https://openrouter.ai/api/v1"
+        }
+      ],
+      "get": {
+        "operationId": "getRankingsDaily",
+        "summary": "Daily token totals for top 50 models",
+        "tags": [
+          "Datasets"
+        ]
+      }
+    },
+    "/datasets/session-cost": {
+      "servers": [
+        {
+          "url": "https://openrouter.ai/api/v1"
+        }
+      ],
+      "get": {
+        "operationId": "getSessionCost",
+        "summary": "Cost per session by harness and model",
+        "tags": [
+          "Datasets"
+        ]
+      }
+    },
+    "/embeddings": {
+      "servers": [
+        {
+          "url": "https://openrouter.ai/api/v1"
+        }
+      ],
+      "post": {
+        "operationId": "createEmbeddings",
+        "summary": "Submit an embedding request",
+        "tags": [
+          "Embeddings"
+        ]
+      }
+    },
+    "/embeddings/models": {
+      "servers": [
+        {
+          "url": "https://openrouter.ai/api/v1"
+        }
+      ],
+      "get": {
+        "operationId": "listEmbeddingsModels",
+        "summary": "List all embeddings models",
+        "tags": [
+          "Embeddings"
+        ]
+      }
+    },
+    "/files": {
+      "servers": [
+        {
+          "url": "https://openrouter.ai/api/v1"
+        }
+      ],
+      "get": {
+        "operationId": "listFiles",
+        "summary": "List files",
+        "tags": [
+          "Files"
+        ]
+      },
+      "post": {
+        "operationId": "uploadFile",
+        "summary": "Upload a file",
+        "tags": [
+          "Files"
+        ]
+      }
+    },
+    "/files/{file_id}": {
+      "servers": [
+        {
+          "url": "https://openrouter.ai/api/v1"
+        }
+      ],
+      "delete": {
+        "operationId": "deleteFile",
+        "summary": "Delete a file",
+        "tags": [
+          "Files"
+        ]
+      },
+      "get": {
+        "operationId": "getFileMetadata",
+        "summary": "Get file metadata",
+        "tags": [
+          "Files"
+        ]
+      }
+    },
+    "/files/{file_id}/content": {
+      "servers": [
+        {
+          "url": "https://openrouter.ai/api/v1"
+        }
+      ],
+      "get": {
+        "operationId": "downloadFileContent",
+        "summary": "Download file content",
+        "tags": [
+          "Files"
+        ]
+      }
+    },
+    "/generation": {
+      "servers": [
+        {
+          "url": "https://openrouter.ai/api/v1"
+        }
+      ],
+      "get": {
+        "operationId": "getGeneration",
+        "summary": "Get request & usage metadata for a generation",
+        "tags": [
+          "Generations"
+        ]
+      }
+    },
+    "/generation/content": {
+      "servers": [
+        {
+          "url": "https://openrouter.ai/api/v1"
+        }
+      ],
+      "get": {
+        "operationId": "listGenerationContent",
+        "summary": "Get stored prompt, completion, and error content for a generation",
+        "tags": [
+          "Generations"
+        ]
+      }
+    },
+    "/generation/feedback": {
+      "servers": [
+        {
+          "url": "https://openrouter.ai/api/v1"
+        }
+      ],
+      "post": {
+        "operationId": "submitGenerationFeedback",
+        "summary": "Submit feedback for a generation",
+        "tags": [
+          "Generations"
+        ]
+      }
+    },
+    "/guardrails": {
+      "servers": [
+        {
+          "url": "https://openrouter.ai/api/v1"
+        }
+      ],
+      "get": {
+        "operationId": "listGuardrails",
+        "summary": "List guardrails",
+        "tags": [
+          "Guardrails"
+        ]
+      },
+      "post": {
+        "operationId": "createGuardrail",
+        "summary": "Create a guardrail",
+        "tags": [
+          "Guardrails"
+        ]
+      }
+    },
+    "/guardrails/{id}": {
+      "servers": [
+        {
+          "url": "https://openrouter.ai/api/v1"
+        }
+      ],
+      "delete": {
+        "operationId": "deleteGuardrail",
+        "summary": "Delete a guardrail",
+        "tags": [
+          "Guardrails"
+        ]
+      },
+      "get": {
+        "operationId": "getGuardrail",
+        "summary": "Get a guardrail",
+        "tags": [
+          "Guardrails"
+        ]
+      },
+      "patch": {
+        "operationId": "updateGuardrail",
+        "summary": "Update a guardrail",
+        "tags": [
+          "Guardrails"
+        ]
+      }
+    },
+    "/guardrails/{id}/assignments/keys": {
+      "servers": [
+        {
+          "url": "https://openrouter.ai/api/v1"
+        }
+      ],
+      "get": {
+        "operationId": "listGuardrailKeyAssignments",
+        "summary": "List key assignments for a guardrail",
+        "tags": [
+          "Guardrails"
+        ]
+      },
+      "post": {
+        "operationId": "bulkAssignKeysToGuardrail",
+        "summary": "Bulk assign keys to a guardrail",
+        "tags": [
+          "Guardrails"
+        ]
+      }
+    },
+    "/guardrails/{id}/assignments/keys/remove": {
+      "servers": [
+        {
+          "url": "https://openrouter.ai/api/v1"
+        }
+      ],
+      "post": {
+        "operationId": "bulkUnassignKeysFromGuardrail",
+        "summary": "Bulk unassign keys from a guardrail",
+        "tags": [
+          "Guardrails"
+        ]
+      }
+    },
+    "/guardrails/{id}/assignments/members": {
+      "servers": [
+        {
+          "url": "https://openrouter.ai/api/v1"
+        }
+      ],
+      "get": {
+        "operationId": "listGuardrailMemberAssignments",
+        "summary": "List member assignments for a guardrail",
+        "tags": [
+          "Guardrails"
+        ]
+      },
+      "post": {
+        "operationId": "bulkAssignMembersToGuardrail",
+        "summary": "Bulk assign members to a guardrail",
+        "tags": [
+          "Guardrails"
+        ]
+      }
+    },
+    "/guardrails/{id}/assignments/members/remove": {
+      "servers": [
+        {
+          "url": "https://openrouter.ai/api/v1"
+        }
+      ],
+      "post": {
+        "operationId": "bulkUnassignMembersFromGuardrail",
+        "summary": "Bulk unassign members from a guardrail",
+        "tags": [
+          "Guardrails"
+        ]
+      }
+    },
+    "/guardrails/assignments/keys": {
+      "servers": [
+        {
+          "url": "https://openrouter.ai/api/v1"
+        }
+      ],
+      "get": {
+        "operationId": "listKeyAssignments",
+        "summary": "List all key assignments",
+        "tags": [
+          "Guardrails"
+        ]
+      }
+    },
+    "/guardrails/assignments/members": {
+      "servers": [
+        {
+          "url": "https://openrouter.ai/api/v1"
+        }
+      ],
+      "get": {
+        "operationId": "listMemberAssignments",
+        "summary": "List all member assignments",
+        "tags": [
+          "Guardrails"
+        ]
+      }
+    },
+    "/key": {
+      "servers": [
+        {
+          "url": "https://openrouter.ai/api/v1"
+        }
+      ],
+      "get": {
+        "operationId": "getCurrentKey",
+        "summary": "Get current API key",
+        "tags": [
+          "API Keys"
+        ]
+      }
+    },
+    "/keys": {
+      "servers": [
+        {
+          "url": "https://openrouter.ai/api/v1"
+        }
+      ],
+      "get": {
+        "operationId": "list",
+        "summary": "List API keys",
+        "tags": [
+          "API Keys"
+        ]
+      },
+      "post": {
+        "operationId": "createKeys",
+        "summary": "Create a new API key",
+        "tags": [
+          "API Keys"
+        ]
+      }
+    },
+    "/keys/{hash}": {
+      "servers": [
+        {
+          "url": "https://openrouter.ai/api/v1"
+        }
+      ],
+      "delete": {
+        "operationId": "deleteKeys",
+        "summary": "Delete an API key",
+        "tags": [
+          "API Keys"
+        ]
+      },
+      "get": {
+        "operationId": "getKey",
+        "summary": "Get a single API key",
+        "tags": [
+          "API Keys"
+        ]
+      },
+      "patch": {
+        "operationId": "updateKeys",
+        "summary": "Update an API key",
+        "tags": [
+          "API Keys"
+        ]
+      }
+    },
+    "/messages": {
+      "servers": [
+        {
+          "url": "https://openrouter.ai/api/v1"
+        }
+      ],
+      "post": {
+        "operationId": "createMessages",
+        "summary": "Create a message",
+        "tags": [
+          "Anthropic Messages"
+        ]
+      }
+    },
+    "/models": {
+      "servers": [
+        {
+          "url": "https://openrouter.ai/api/v1"
+        }
+      ],
+      "get": {
+        "operationId": "getModels",
+        "summary": "List all models and their properties",
+        "tags": [
+          "Models"
+        ]
+      }
+    },
+    "/models/{author}/{slug}/endpoints": {
+      "servers": [
+        {
+          "url": "https://openrouter.ai/api/v1"
+        }
+      ],
+      "get": {
+        "operationId": "listEndpoints",
+        "summary": "List all endpoints for a model",
+        "tags": [
+          "Endpoints"
+        ]
+      }
+    },
+    "/models/count": {
+      "servers": [
+        {
+          "url": "https://openrouter.ai/api/v1"
+        }
+      ],
+      "get": {
+        "operationId": "listModelsCount",
+        "summary": "Get total count of available models",
+        "tags": [
+          "Models"
+        ]
+      }
+    },
+    "/models/user": {
+      "servers": [
+        {
+          "url": "https://openrouter.ai/api/v1"
+        }
+      ],
+      "get": {
+        "operationId": "listModelsUser",
+        "summary": "List models filtered by user provider preferences, privacy settings, and guardrails",
+        "tags": [
+          "Models"
+        ]
+      }
+    },
+    "/observability/destinations": {
+      "servers": [
+        {
+          "url": "https://openrouter.ai/api/v1"
+        }
+      ],
+      "get": {
+        "operationId": "listObservabilityDestinations",
+        "summary": "List observability destinations",
+        "tags": [
+          "Observability"
+        ]
+      },
+      "post": {
+        "operationId": "createObservabilityDestination",
+        "summary": "Create an observability destination",
+        "tags": [
+          "Observability"
+        ]
+      }
+    },
+    "/observability/destinations/{id}": {
+      "servers": [
+        {
+          "url": "https://openrouter.ai/api/v1"
+        }
+      ],
+      "delete": {
+        "operationId": "deleteObservabilityDestination",
+        "summary": "Delete an observability destination",
+        "tags": [
+          "Observability"
+        ]
+      },
+      "get": {
+        "operationId": "getObservabilityDestination",
+        "summary": "Get an observability destination",
+        "tags": [
+          "Observability"
+        ]
+      },
+      "patch": {
+        "operationId": "updateObservabilityDestination",
+        "summary": "Update an observability destination",
+        "tags": [
+          "Observability"
+        ]
+      }
+    },
+    "/organization/members": {
+      "servers": [
+        {
+          "url": "https://openrouter.ai/api/v1"
+        }
+      ],
+      "get": {
+        "operationId": "listOrganizationMembers",
+        "summary": "List organization members",
+        "tags": [
+          "Organization"
+        ]
+      }
+    },
+    "/presets": {
+      "servers": [
+        {
+          "url": "https://openrouter.ai/api/v1"
+        }
+      ],
+      "get": {
+        "operationId": "listPresets",
+        "summary": "List presets",
+        "tags": [
+          "Presets"
+        ]
+      }
+    },
+    "/presets/{slug}": {
+      "servers": [
+        {
+          "url": "https://openrouter.ai/api/v1"
+        }
+      ],
+      "get": {
+        "operationId": "getPreset",
+        "summary": "Get a preset",
+        "tags": [
+          "Presets"
+        ]
+      }
+    },
+    "/presets/{slug}/chat/completions": {
+      "servers": [
+        {
+          "url": "https://openrouter.ai/api/v1"
+        }
+      ],
+      "post": {
+        "operationId": "createPresetsChatCompletions",
+        "summary": "Create a preset from a chat-completions request body",
+        "tags": [
+          "Presets"
+        ]
+      }
+    },
+    "/presets/{slug}/messages": {
+      "servers": [
+        {
+          "url": "https://openrouter.ai/api/v1"
+        }
+      ],
+      "post": {
+        "operationId": "createPresetsMessages",
+        "summary": "Create a preset from a messages request body",
+        "tags": [
+          "Presets"
+        ]
+      }
+    },
+    "/presets/{slug}/responses": {
+      "servers": [
+        {
+          "url": "https://openrouter.ai/api/v1"
+        }
+      ],
+      "post": {
+        "operationId": "createPresetsResponses",
+        "summary": "Create a preset from a responses request body",
+        "tags": [
+          "Presets"
+        ]
+      }
+    },
+    "/presets/{slug}/versions": {
+      "servers": [
+        {
+          "url": "https://openrouter.ai/api/v1"
+        }
+      ],
+      "get": {
+        "operationId": "listPresetVersions",
+        "summary": "List versions of a preset",
+        "tags": [
+          "Presets"
+        ]
+      }
+    },
+    "/presets/{slug}/versions/{version}": {
+      "servers": [
+        {
+          "url": "https://openrouter.ai/api/v1"
+        }
+      ],
+      "get": {
+        "operationId": "getPresetVersion",
+        "summary": "Get a specific version of a preset",
+        "tags": [
+          "Presets"
+        ]
+      }
+    },
+    "/providers": {
+      "servers": [
+        {
+          "url": "https://openrouter.ai/api/v1"
+        }
+      ],
+      "get": {
+        "operationId": "listProviders",
+        "summary": "List all providers",
+        "tags": [
+          "Providers"
+        ]
+      }
+    },
+    "/rerank": {
+      "servers": [
+        {
+          "url": "https://openrouter.ai/api/v1"
+        }
+      ],
+      "post": {
+        "operationId": "createRerank",
+        "summary": "Submit a rerank request",
+        "tags": [
+          "Rerank"
+        ]
+      }
+    },
+    "/responses": {
+      "servers": [
+        {
+          "url": "https://openrouter.ai/api/v1"
+        }
+      ],
+      "post": {
+        "operationId": "createResponses",
+        "summary": "Create a response",
+        "tags": [
+          "Responses",
+          "beta.responses"
+        ]
+      }
+    },
+    "/videos": {
+      "servers": [
+        {
+          "url": "https://openrouter.ai/api/v1"
+        }
+      ],
+      "post": {
+        "operationId": "createVideos",
+        "summary": "Submit a video generation request",
+        "tags": [
+          "Video Generation"
+        ]
+      }
+    },
+    "/videos/{jobId}": {
+      "servers": [
+        {
+          "url": "https://openrouter.ai/api/v1"
+        }
+      ],
+      "get": {
+        "operationId": "getVideos",
+        "summary": "Poll video generation status",
+        "tags": [
+          "Video Generation"
+        ]
+      }
+    },
+    "/videos/{jobId}/content": {
+      "servers": [
+        {
+          "url": "https://openrouter.ai/api/v1"
+        }
+      ],
+      "get": {
+        "operationId": "listVideosContent",
+        "summary": "Download generated video content",
+        "tags": [
+          "Video Generation"
+        ]
+      }
+    },
+    "/videos/models": {
+      "servers": [
+        {
+          "url": "https://openrouter.ai/api/v1"
+        }
+      ],
+      "get": {
+        "operationId": "listVideosModels",
+        "summary": "List all video generation models",
+        "tags": [
+          "Video Generation"
+        ]
+      }
+    },
+    "/workspaces": {
+      "servers": [
+        {
+          "url": "https://openrouter.ai/api/v1"
+        }
+      ],
+      "get": {
+        "operationId": "listWorkspaces",
+        "summary": "List workspaces",
+        "tags": [
+          "Workspaces"
+        ]
+      },
+      "post": {
+        "operationId": "createWorkspace",
+        "summary": "Create a workspace",
+        "tags": [
+          "Workspaces"
+        ]
+      }
+    },
+    "/workspaces/{id}": {
+      "servers": [
+        {
+          "url": "https://openrouter.ai/api/v1"
+        }
+      ],
+      "delete": {
+        "operationId": "deleteWorkspace",
+        "summary": "Delete a workspace",
+        "tags": [
+          "Workspaces"
+        ]
+      },
+      "get": {
+        "operationId": "getWorkspace",
+        "summary": "Get a workspace",
+        "tags": [
+          "Workspaces"
+        ]
+      },
+      "patch": {
+        "operationId": "updateWorkspace",
+        "summary": "Update a workspace",
+        "tags": [
+          "Workspaces"
+        ]
+      }
+    },
+    "/workspaces/{id}/budgets": {
+      "servers": [
+        {
+          "url": "https://openrouter.ai/api/v1"
+        }
+      ],
+      "get": {
+        "operationId": "listWorkspaceBudgets",
+        "summary": "List workspace budgets",
+        "tags": [
+          "Workspaces"
+        ]
+      }
+    },
+    "/workspaces/{id}/budgets/{interval}": {
+      "servers": [
+        {
+          "url": "https://openrouter.ai/api/v1"
+        }
+      ],
+      "delete": {
+        "operationId": "deleteWorkspaceBudget",
+        "summary": "Delete a workspace budget",
+        "tags": [
+          "Workspaces"
+        ]
+      },
+      "get": {
+        "operationId": "getWorkspaceBudget",
+        "summary": "Get a workspace budget",
+        "tags": [
+          "Workspaces"
+        ]
+      },
+      "put": {
+        "operationId": "upsertWorkspaceBudget",
+        "summary": "Create or update a workspace budget",
+        "tags": [
+          "Workspaces"
+        ]
+      }
+    },
+    "/workspaces/{id}/members": {
+      "servers": [
+        {
+          "url": "https://openrouter.ai/api/v1"
+        }
+      ],
+      "get": {
+        "operationId": "listWorkspaceMembers",
+        "summary": "List workspace members",
+        "tags": [
+          "Workspaces"
+        ]
+      }
+    },
+    "/workspaces/{id}/members/add": {
+      "servers": [
+        {
+          "url": "https://openrouter.ai/api/v1"
+        }
+      ],
+      "post": {
+        "operationId": "bulkAddWorkspaceMembers",
+        "summary": "Bulk add members to a workspace",
+        "tags": [
+          "Workspaces"
+        ]
+      }
+    },
+    "/workspaces/{id}/members/remove": {
+      "servers": [
+        {
+          "url": "https://openrouter.ai/api/v1"
+        }
+      ],
+      "post": {
+        "operationId": "bulkRemoveWorkspaceMembers",
+        "summary": "Bulk remove members from a workspace",
+        "tags": [
+          "Workspaces"
+        ]
+      }
+    }
+  }
+}