# OpenRouter integration

> Unified LLM API: chat completions, responses, messages, embeddings, images, audio, video and rerank across hundreds of models, plus key, credit, generation, provider, workspace and guardrail management

- Authentication: apiKey

## Tools (144)

- **Activate a validated private endpoint**: Makes a validated draft private endpoint routable. Management key required.
- **Bulk add members to a workspace**: Adds organization members to a workspace with their organization role. Management key required.
- **Bulk assign keys to a guardrail**: Assigns API keys to a guardrail, replacing any existing assignment per key. Management key required.
- **Bulk assign members to a guardrail**: Assigns organization members to a guardrail. Management key required.
- **Bulk remove members from a workspace**: Removes members from a workspace. Management key required.
- **Bulk unassign keys from a guardrail**: Removes API keys from a guardrail. Management key required.
- **Bulk unassign members from a guardrail**: Removes organization members from a guardrail. Management key required.
- **Copy workspace secrets to an intern**: Copies named workspace secrets into one intern's scope.
- **Cost per session by harness and model**: Weekly aggregated cost-per-session cells for published harnesses and models.
- **Create a batch**: Creates an asynchronous batch of requests against one endpoint.
- **Create a BYOK provider credential**: Stores a bring-your-own-key provider credential, encrypted at rest. Management key required.
- **Create a chat completion**: Chat completion in the OpenAI schema; supports streaming, tools, structured output, plugins and provider routing.
- **Create a guardrail**: Creates a guardrail (spend limit, model/provider allowlists, ZDR, content filters). Management key required.
- **Create a message**: Message in the Anthropic Messages format; supports images, PDFs, tools and extended thinking.
- **Create a new API key**: Creates an API key; the plaintext key is returned once. Management key required.
- **Create an intern**: Creates an intern and its private vault; optionally starts provisioning.
- **Create an observability destination**: Creates a destination that forwards request traces to a tool such as Langfuse or Datadog. Management key required.
- **Create a preset from a chat-completions request body**: Creates a preset or new preset version from a chat-completions request body.
- **Create a preset from a messages request body**: Creates a preset or new preset version from an Anthropic-style messages request body.
- **Create a preset from a responses request body**: Creates a preset or new preset version from a Responses API request body.
- **Create a private endpoint**: Creates a draft private endpoint for your own model deployment. Management key required.
- **Create a response**: Response in the OpenResponses (OpenAI Responses) format; streaming or non-streaming, with tools and reasoning.
- **Create a SCIM group mapping**: Maps a SCIM group to a workspace role. Management key required.
- **Create a workspace**: Creates a workspace with default models and logging settings. Management key required.
- **Create or update a workspace budget**: Sets the workspace spending budget for an interval. Management key required.
- **Create speech**: Synthesizes audio from text and returns a raw audio bytestream.
- **Create transcription**: Transcribes audio into text from base64 JSON, multipart upload, or URL.
- **Daily token totals for top 50 models**: Top 50 public models per day by token usage plus an aggregated other row.
- **Deactivate a registered end user**: Soft-deactivates an end-user registration. Management key required.
- **Delete a batch**: Deletes a batch in a terminal status together with its stored requests and results.
- **Delete a BYOK provider credential**: Soft-deletes a BYOK credential and wipes its key material. Management key required.
- **Delete a file**: Permanently deletes a file owned by the workspace.
- **Delete a guardrail**: Deletes a guardrail. Management key required.
- **Delete an API key**: Deletes an API key by hash. Management key required.
- **Delete an intern**: Starts teardown of an intern, its runtime and private vault.
- **Delete an intern secret**: Deletes a secret stored for one intern.
- **Delete an observability destination**: Soft-deletes an observability destination. Management key required.
- **Delete a private endpoint**: Deletes a private endpoint and stops routing to it. Management key required.
- **Delete a SCIM group mapping**: Deletes a SCIM group-to-workspace mapping; keep_members is required. Management key required.
- **Delete a workspace**: Deletes a workspace that has no active API keys. Management key required.
- **Delete a workspace budget**: Removes the workspace budget for an interval. Management key required.
- **Delete a workspace secret**: Deletes a secret from the key's workspace vault.
- **Disable a private endpoint**: Stops routing to an active private endpoint without deleting it. Management key required.
- **Download container file content**: Streams the raw bytes of a container file.
- **Download file content**: Downloads raw bytes of a server-created file; uploaded files return 400.
- **Download generated video content**: Streams generated video bytes from the upstream provider.
- **Enable a private endpoint**: Resumes routing to a disabled private endpoint. Management key required.
- **Generate an image**: Generates images from a text prompt (optionally with reference images) via the image router.
- **Get a batch**: Returns a batch with status and request counts; terminal batches include results.
- **Get a BYOK provider credential**: Returns one BYOK provider credential by id. Management key required.
- **Get a guardrail**: Returns one guardrail by id. Management key required.
- **Get a model by its slug**: Returns full details for one model by author and slug.
- **Get an intern**: Returns lifecycle state and settings of one intern.
- **Get an intern's daemon access**: Returns the daemon origin and token that attach the CLI to a running intern.
- **Get an observability destination**: Returns one observability destination. Management key required.
- **Get a preset**: Returns a preset by slug with its current version.
- **Get a private endpoint**: Returns a private endpoint with upstream configuration and pricing. Management key required.
- **Get a registered end user**: Returns an end-user registration by tracking id. Management key required.
- **Get a SCIM group mapping**: Returns one SCIM group-to-workspace mapping. Management key required.
- **Get a server tool**: Returns one server tool by canonical name or alias.
- **Get a single API key**: Returns one API key by hash. Management key required.
- **Get a specific version of a preset**: Returns one version of a preset by version number.
- **Get available analytics metrics and dimensions**: Returns the metrics, dimensions, filter operators and granularities accepted by the analytics query endpoint. Management key required.
- **Get a workspace**: Returns one workspace by id or slug. Management key required.
- **Get a workspace budget**: Returns the workspace budget for an interval. Management key required.
- **Get current API key**: Returns label, limit, usage and rate-limit info for the key making the request.
- **Get file metadata**: Returns metadata for one workspace file.
- **Get organization settings**: Returns organization settings. Management key required.
- **Get remaining credits**: Total credits purchased and used for the account. Management key required.
- **Get request & usage metadata for a generation**: Returns cost, tokens, latency and provider metadata for a completed generation id.
- **Get SCIM directory sync status**: Returns the status of a SCIM directory sync job. Management key required.
- **Get stored prompt, completion, and error content for a generation**: Returns the stored prompt, completion and error content of a generation.
- **Get total count of available models**: Returns the number of available models, optionally by output modality.
- **Get user activity grouped by endpoint**: Returns user activity data grouped by endpoint for the last 30 completed UTC days. Management key required.
- **List all embeddings models**: Lists available embeddings models and their properties.
- **List all endpoints for a model**: Lists provider endpoints for a model with pricing and limits.
- **List all key assignments**: Lists all API key guardrail assignments. Management key required.
- **List all member assignments**: Lists all organization member guardrail assignments. Management key required.
- **List all models and their properties**: Lists models with pricing, context length and capabilities; many filters.
- **List all providers**: Lists all model providers on OpenRouter.
- **List all video generation models**: Lists video generation models and their properties.
- **List API keys**: Lists API keys on the account. Management key required.
- **List batches**: Lists batches in the key's workspace, newest first, with cursor pagination.
- **List Benchmarks**: Aggregated model benchmark scores from several sources, filterable by task type.
- **List BYOK provider credentials**: Lists bring-your-own-key provider credentials for a workspace. Management key required.
- **List container files**: Lists files in a tool-execution container, in path order, with cursor pagination.
- **List endpoints for an image model**: Per-endpoint supported parameters, pricing and passthrough allowlist for an image model.
- **List files**: Lists files in the key's workspace, in OpenRouter storage or on a provider.
- **List guardrails**: Lists guardrails. Management key required.
- **List image generation models**: Lists image generation models with their supported-parameter superset.
- **List interns**: Lists interns (hosted agents) visible to the key, newest first.
- **List intern secrets**: Lists metadata of secrets stored for one intern.
- **List key assignments for a guardrail**: Lists API keys assigned to a guardrail. Management key required.
- **List member assignments for a guardrail**: Lists organization members assigned to a guardrail. Management key required.
- **List models filtered by user provider preferences, privacy settings, and guardrails**: Lists models usable under the caller's provider preferences, privacy settings and guardrails.
- **List observability destinations**: Lists observability (broadcast) destinations for a workspace. Management key required.
- **List organization members**: Lists members of the organization. Management key required.
- **List presets**: Lists presets, most recently updated first.
- **List private endpoints**: Lists the organization's private endpoints, including drafts. Management key required.
- **List registered end users**: Lists end-user tracking registrations for the organization. Management key required.
- **List SCIM group mappings**: Lists SCIM group-to-workspace mappings. Management key required.
- **List SCIM groups**: Lists SCIM groups for the organization. Management key required.
- **List server tools**: Lists server tools OpenRouter can run for a model, with engines and pricing.
- **List the secrets an intern receives**: Lists the effective secrets (own, attached vault, workspace) an intern's outbound requests receive.
- **List versions of a preset**: Lists all versions of a preset, oldest first.
- **List workspace budgets**: Lists budgets configured for a workspace. Management key required.
- **List workspace members**: Lists members of a workspace. Management key required.
- **List workspaces**: Lists workspaces for the account. Management key required.
- **List workspace secrets**: Lists metadata of secrets stored in the key's workspace vault.
- **Poll video generation status**: Returns status of a video job, with content URLs when completed.
- **Preview the impact of ZDR on the available endpoints**: Lists model endpoints that qualify for zero data retention routing.
- **Promote a container file into workspace documents**: Copies a container file into durable workspace document storage so it outlives the container.
- **Provision an intern**: Starts first boot, or resumes a suspended intern. Takes no body.
- **Query analytics data**: Runs an analytics query with metrics, dimensions, filters and a time range. Read-only despite POST. Management key required.
- **Register an end user**: Registers a caller-supplied tracking id under the organization. Management key required.
- **Retrieve a container file**: Returns metadata of one file in a container.
- **Set private endpoint pricing**: Sets negotiated per-token rates reported for a private endpoint. Management key required.
- **Sign a daemon request with the caller's identity**: Signs a daemon request digest bound to the intern and signed-in member (OAuth session only).
- **Start an intern run without waiting for it**: Starts an intern run and returns 202 with a session_id immediately.
- **Start a SCIM directory sync**: Starts a SCIM directory sync job. Management key required.
- **Store an intern secret**: Creates or replaces an encrypted secret for one intern, bound to exact hostnames.
- **Store a workspace secret**: Creates or replaces an encrypted workspace secret bound to exact hostnames.
- **Stream a chat completion with an intern**: Sends a prompt to an intern and streams the reply as OpenAI-compatible SSE.
- **Submit a Decisions request**: Submits a Decisions request to the Decisions router (alpha).
- **Submit an embedding request**: Creates embeddings for text, tokens or multimodal input.
- **Submit a rerank request**: Reranks documents against a query with a rerank model.
- **Submit a System One request**: Sends state and typed questions to a System One model and returns its answers.
- **Submit a video generation request**: Submits an async video generation job and returns a polling URL.
- **Submit feedback for a generation**: Submits structured feedback on a generation. Management key required.
- **Suspend an intern**: Stops the intern runtime, keeping disk and config for a later provision.
- **Task classification market share**: Market share of OpenRouter traffic by task classification over a trailing window.
- **Top apps by token usage**: Top public apps on OpenRouter ranked by token usage in a date window.
- **Update a BYOK provider credential**: Updates a BYOK credential, optionally rotating the raw key. Management key required.
- **Update a draft private endpoint**: Replaces a draft private endpoint's upstream configuration. Management key required.
- **Update a guardrail**: Updates a guardrail; collection fields use replace semantics. Management key required.
- **Update an API key**: Updates a key's name, limit, disabled state or workspace. Management key required.
- **Update an intern**: Changes an intern's name, description, instructions or model.
- **Update an observability destination**: Updates an observability destination; only supplied fields change. Management key required.
- **Update a registered end user**: Activates or deactivates an end-user registration. Management key required.
- **Update a SCIM group mapping**: Changes the role of a SCIM group mapping. Management key required.
- **Update a workspace**: Updates workspace settings by id or slug. Management key required.
- **Update organization settings**: Updates organization settings such as the filtered model catalog. Management key required.
- **Upload a file**: Uploads a file (max 100 MB) for use in later API calls.
- **Validate a draft private endpoint**: Sends a live test request to a draft private endpoint using the workspace's BYOK credential. Management key required.

Connect OpenRouter in General Input: https://www.generalinput.com/apps/openrouter