Skip to content
Changelog

Report a bug

Openrouter integration: operations for AI agents

Openrouter connects to Type.com as an integration. This page lists the 138 operations documented for Claude and Codex in Type.com: 72 read, 49 write, 17 destructive.

About Openrouter

OpenRouter is a platform that provides a unified API for accessing various large language models (LLMs) from different providers, allowing developers to integrate multiple AI models seamlessly.

Categories: Developer Tools & IT

How to connect Openrouter to Type.com

Access
Organization connection: one shared account for the workspace.
MCP
Selected AI media-generation operations are not available through Type’s MCP server. Other operations remain available through MCP, subject to your connection’s permissions. These MCP restrictions do not apply within Type.

To add the connection, follow the steps in Space connections.

Documented operations

138 operations. Your connection's permissions determine which operations are available. API references describe the vendor surface; they do not expand your connection's credentials or access.

138 operations listed.

Analytics

  • Read

    Get user activity grouped by endpoint

    Returns user activity data grouped by endpoint for the last 30 (completed) UTC days. Pass workspaceid to scope the response to a single workspace.

  • Read

    Get available analytics metrics and dimensions

    Returns the available metrics, dimensions, filter operators, and granularities for the analytics query endpoint. Management key required.

  • Read

    Query analytics data

    Execute an analytics query with specified metrics, dimensions, filters, and time range. Management key required.

Alpha.decisions

  • Write

    Submit a Decisions request

    Submits a Decisions request to the Decisions router

TTS

  • Write

    Create speech

    Synthesizes audio from the input text. Returns a raw audio bytestream in the requested format (e.g. mp3, pcm, wav).

STT

  • Write

    Create transcription

    Transcribes audio into text. Accepts base64-encoded audio input as JSON, an OpenAI-style multipart/form-data file upload, or a URL the provider downloads directly, and returns the transcribed text.

OAuth

  • Read

    OpenRouter access token signing keys

    RFC 7517 JWK Set containing the public keys OpenRouter signs access tokens with.

  • Write

    Exchange authorization code for API key

    Exchange an authorization code from the PKCE flow for a user-controlled API key

  • Write

    Create authorization code

    Create an authorization code for the PKCE flow to generate a user-controlled API key

  • Write

    Exchange a workload identity token

    RFC 8693 token exchange. Presents a JWT from an issuer your organization trusts (Settings → Workload identity) and receives a short-lived OpenRouter access token that acts as the API key the matching federation policy targets.

Batch

  • Read

    List batches

    Lists batches in the workspace of the authenticating API key, newest first. To fetch the next page, pass the previous page's lastid as after. List items omit results. Use GET /batches/{id} to get them. See the Batch API Quickstart.

  • Read

    Get a batch

    Returns a batch with its status and request counts. Batches in a terminal status include results. Failed batches report the reason in error.message. See the Batch API Quickstart.

  • Write

    Create a batch

    Creates a batch of requests that run asynchronously against a single endpoint (/v1/chat/completions, /v1/responses, /v1/messages, /v1/embeddings). Returns 202 with status: "validating". Poll GET /batches/{id} for progress and results. See the Batch API Quickstart.

  • Destructive

    Delete a batch

    Deletes a batch in a terminal status (completed, failed, expired, or cancelled) and its stored requests and results. Batches still in progress return 409. Billing and usage records are kept. See the Batch API Quickstart.

Benchmarks

  • Read

    List Benchmarks

    Unified benchmark endpoint that aggregates scores from multiple benchmark sources (Artificial Analysis, Design Arena, and OpenRouter's own tau-bench, GPQA, and web-search evals).

BYOK

  • Read

    List BYOK provider credentials

    List the bring-your-own-key (BYOK) provider credentials for the authenticated entity's default workspace. Use the workspaceid query parameter to scope the result to a different workspace, or the provider query parameter to filter by upstream provider. Management key required.

  • Read

    Get a BYOK provider credential

    Get a single bring-your-own-key (BYOK) provider credential by its id. Management key required.

  • Write

    Create a BYOK provider credential

    Create a new bring-your-own-key (BYOK) provider credential. The raw key is encrypted at rest and never returned in API responses.

  • Write

    Update a BYOK provider credential

    Update an existing bring-your-own-key (BYOK) provider credential by its id. Include the key field to rotate the raw provider API key in-place (the previous key material is overwritten).

  • Destructive

    Delete a BYOK provider credential

    Delete (soft-delete) a bring-your-own-key (BYOK) provider credential by its id. The encrypted key material is wiped and the record is marked as deleted. Management key required.

Chat

  • Write

    Create a chat completion

    Sends a request for a model response for the given chat conversation. Supports both streaming and non-streaming modes.

Classifications

  • Read

    Task classification market share

    Returns the market-share breakdown of OpenRouter traffic by task classification (e.g. code generation, web search, summarization) over a trailing time window.

Containers

  • Read

    List container files

    Lists the files in a container, in lexicographic path order. The container id is the canonical id returned in bash/shell tool results; a restarted session is a separate container with its own id.

  • Read

    Retrieve a container file

    Returns the metadata of a single file in a container.

  • Read

    Download container file content

    Streams the raw bytes of a file in a container.

  • Write

    Promote a container file into workspace documents

    Copies a file from the container's sandbox prefix into the workspace's durable document storage, so it outlives the container. Returns the new document in the Files API shape, with a durable file id in the documents namespace.

Credits

  • Read

    Get remaining credits

    Get total credits purchased and used for the authenticated user. Management key required.

Datasets

  • Read

    Top apps by token usage

    Returns the top public apps on OpenRouter ranked by token usage inside the requested date window, matching the public apps marketplace on openrouter.ai/apps.

  • Read

    Daily token totals for top 50 models

    Returns the top 50 public models per day by total token usage on OpenRouter, plus a single aggregated other row per day that sums every model outside that top 50. Token totals are prompttokens + completiontokens, matching the public rankings chart on openrouter.ai/rankings.

  • Read

    Cost per session by harness and model

    Returns weekly refreshed, aggregated cost-per-session cells for the published harnesses. Sessions are never pooled across apps. Medians are of per-session USD spend, and privacy-preserving aggregation never exposes clerkuserid values or per-session rows.

Embeddings

  • Read

    List all embeddings models

    Returns a list of all available embeddings models and their properties

  • Write

    Submit an embedding request

    Submits an embedding request to the embeddings router

Endpoints

  • Read

    Preview the impact of ZDR on the available endpoints

    GET /endpoints/zdr

  • Read

    List all endpoints for a model

    GET /models/{author}/{slug}/endpoints

External Users

  • Read

    List registered external users

    List registrations belonging to the authenticated organization. Inactive registrations are excluded by default. Management key required.

  • Read

    Get a registered external user

    Retrieve an active or inactive registration by its URL-encoded, caller-supplied tracking ID. Management key required.

  • Write

    Register an external user

    Register a caller-supplied tracking ID under the authenticated organization. No login account, policy, or credentials are created. Management key required.

  • Write

    Update a registered external user

    Update registration state without changing identity. State changes do not enforce inference access. Management key required.

  • Destructive

    Deactivate a registered external user

    Soft-deactivate a registration while retaining its tracking ID. Repeat deactivation succeeds. This does not block inference; reactivate through PATCH. Management key required.

Files

  • Read

    List files

    Lists files belonging to the workspace of the authenticating API key.

  • Read

    Get file metadata

    Retrieves metadata for a single file owned by the requesting workspace.

  • Read

    Download file content

    Downloads the raw bytes of a file. Only files created server-side are downloadable; uploaded files return 400.

  • Write

    Upload a file

    Uploads a file to be referenced in future API calls. The file is stored under the workspace of the authenticating API key. Maximum file size: 100 MB; empty files are rejected.

  • Destructive

    Delete a file

    Deletes a file owned by the requesting workspace. Deletion is irreversible.

Generations

  • Read

    Get request & usage metadata for a generation

    GET /generation

  • Read

    Get stored prompt, completion, and error content for a generation

    GET /generation/content

  • Write

    Submit feedback for a generation

    Submit structured feedback on a generation the authenticated user made. Management key required.

Guardrails

  • Read

    List guardrails

    List all guardrails for the authenticated user. Management key required.

  • Read

    Get a guardrail

    Get a single guardrail by ID. Management key required.

  • Read

    List key assignments for a guardrail

    List all API key assignments for a specific guardrail. Management key required.

  • Read

    List member assignments for a guardrail

    List all organization member assignments for a specific guardrail. Management key required.

  • Read

    List all key assignments

    List all API key guardrail assignments for the authenticated user. Management key required.

  • Read

    List all member assignments

    List all organization member guardrail assignments for the authenticated user. Management key required.

  • Write

    Create a guardrail

    Create a new guardrail for the authenticated user. A newly created guardrail enforces nothing until it is assigned to API keys or organization members; workspaceid places the guardrail in a workspace but does not apply it to that workspace's traffic.

  • Write

    Update a guardrail

    Update an existing guardrail, or materialize an unconfigured workspace default guardrail. Collection fields use replace semantics: send the full desired set on every update. Management key required.

  • Write

    Bulk assign keys to a guardrail

    Assign multiple API keys to a specific guardrail. A key may hold at most one guardrail; assigning replaces any existing assignment. Management key required.

  • Write

    Bulk unassign keys from a guardrail

    Unassign multiple API keys from a specific guardrail. Management key required.

  • Write

    Bulk assign members to a guardrail

    Assign multiple organization members to a specific guardrail. Management key required.

  • Write

    Bulk unassign members from a guardrail

    Unassign multiple organization members from a specific guardrail. Management key required.

  • Destructive

    Delete a guardrail

    Delete an existing guardrail. Management key required.

Images

  • Read

    List image generation models

    Lists every image generation model with its top-level supported-parameter superset and a URL to its full per-endpoint records.

  • Read

    List endpoints for an image model

    Returns the full per-endpoint records for an image model: each endpoint's definitive supported parameters, pricing, and passthrough allowlist.

  • Write

    Generate an image

    Generates an image from a text prompt via the image generation router

API Keys

  • Read

    Get current API key

    Get information on the API key associated with the current authentication session

  • Read

    List API keys

    List all API keys for the authenticated user. Management key required.

  • Read

    Get a single API key

    Get a single API key by hash. Management key required.

  • Write

    Create a new API key

    Create a new API key for the authenticated user. The plaintext key is returned only in this response. Treat it as a write-only, sensitive value; it cannot be retrieved later. Authenticate with a management key.

  • Write

    Update an API key

    Update an existing API key. Authenticate with a management key. Set workspaceid to move the key to another workspace. The request body accepts only the fields listed below, and unrecognized fields are ignored.

  • Destructive

    Delete an API key

    Delete an existing API key. Authenticate with a management key.

Anthropic Messages

  • Write

    Create a message

    Creates a message using the Anthropic Messages API format. Supports text, images, PDFs, tools, and extended thinking.

Models

  • Read

    Get a model by its slug

    Returns full details for a single model identified by its author and slug (e.g. openai/gpt-4). Supports variant suffixes (e.g. openai/gpt-4:free) and resolves known slug aliases.

  • Read

    List all models and their properties

    GET /models

  • Read

    Get total count of available models

    GET /models/count

  • Read

    List models filtered by user provider preferences, privacy settings, and guardrails

    List models filtered by user provider preferences, privacy settings, and guardrails. Returns text-output models by default; pass outputmodalities (a comma-separated list of text, image, embeddings, audio, video, rerank, speech, transcription, or all) to include other modalities.

Observability

  • Read

    List observability destinations

    List the observability destinations configured for the authenticated entity's default workspace. Use the workspaceid query parameter to scope the result to a different workspace. Only destinations with stable release status are surfaced — destinations of other types are excluded.

  • Read

    Get an observability destination

    Fetch a single observability destination by its UUID. Management key required.

  • Write

    Create an observability destination

    Create a new observability destination. A maximum of 5 destinations per type is allowed. Defaults to the authenticated entity's default workspace; use the workspaceid body field to scope to a different workspace. Management key required.

  • Write

    Update an observability destination

    Update an existing observability destination. Only the fields provided in the request body are updated. Management key required.

  • Destructive

    Delete an observability destination

    Delete an existing observability destination. This performs a soft delete. Management key required.

Organization

  • Read

    List organization members

    List all members of the organization associated with the authenticated management key. Management key required.

  • Read

    Get organization settings

    Get the settings of the organization associated with the authenticated management key. Management key required.

  • Write

    Update organization settings

    Update the settings of the organization associated with the authenticated management key. Management key required.

Presets

  • Read

    List presets

    Lists all presets for the authenticated user, ordered by most recently updated first.

  • Read

    Get a preset

    Retrieves a preset by its slug with its currently designated version inline.

  • Read

    List versions of a preset

    Lists all versions of a preset, ordered by version number ascending (oldest first).

  • Read

    Get a specific version of a preset

    Retrieves a specific version of a preset by its slug and version number.

  • Write

    Create a preset from a chat-completions request body

    Creates a preset (or a new version of an existing one) from an inference request body. Only fields that overlap with the preset config are persisted; other fields (e.g. messages, stream, prompt) are silently ignored.

  • Write

    Create a preset from a messages request body

    Creates a preset (or a new version of an existing one) from an inference request body. Only fields that overlap with the preset config are persisted; other fields (e.g. messages, stream, prompt) are silently ignored.

  • Write

    Create a preset from a responses request body

    Creates a preset (or a new version of an existing one) from an inference request body. Only fields that overlap with the preset config are persisted; other fields (e.g. messages, stream, prompt) are silently ignored.

Private Endpoints

  • Read

    List private endpoints

    List the organization's private endpoints, including drafts. Requires the private endpoints entitlement. Management key required.

  • Read

    Get a private endpoint

    Get one private endpoint with its upstream configuration and current pricing. Management key required.

  • Read

    Validate a draft private endpoint

    Send a live test request to the draft endpoint using the given workspace's BYOK credential for its provider. A passing validation is required before activation. Failed checks return 200 with passed: false. Management key required.

  • Write

    Create a private endpoint

    Create a private endpoint as a draft. Drafts are not routable: validate one with POST /private-endpoints/{id}/validate, then activate it with POST /private-endpoints/{id}/activate.

  • Write

    Update a draft private endpoint

    Replace a draft endpoint's upstream configuration: send upstreammodelid, and baseurl to change it (an omitted baseurl keeps the stored one). Omitted data-policy declarations are kept while the upstream is unchanged and cleared when it changes.

  • Write

    Activate a validated private endpoint

    Make a validated draft routable. Returns 409 when the endpoint was never validated, the validation is stale, or it is already active. Management key required.

  • Write

    Disable a private endpoint

    Stop routing to an active endpoint without deleting it. Management key required.

  • Write

    Enable a private endpoint

    Resume routing to a disabled endpoint. Management key required.

  • Destructive

    Delete a private endpoint

    Delete a private endpoint and stop routing to it. Pass draftonly=true to refuse (409) when the endpoint has been activated. Management key required.

  • Destructive

    Set private endpoint pricing

    Set the negotiated per-token rates reported for requests routed to this endpoint. Applies to drafts and active endpoints; new rates take effect for subsequent requests.

Providers

  • Read

    List all providers

    GET /providers

Rerank

  • Write

    Submit a rerank request

    Submits a rerank request to the rerank router

Responses

  • Write

    Create a response

    Creates a streaming or non-streaming response using OpenResponses API format

SCIM

  • Read

    List SCIM group mappings

    List SCIM group-to-workspace mappings for the organization. Management key required.

  • Read

    Get a SCIM group mapping

    Get a SCIM group-to-workspace mapping. Management key required.

  • Read

    List SCIM groups

    List SCIM groups for the organization. Management key required.

  • Read

    Get SCIM directory sync status

    Get SCIM directory sync status. Management key required.

  • Write

    Create a SCIM group mapping

    Create a SCIM group-to-workspace role mapping. Creating a mapping that already exists with the same role succeeds and re-applies the mapping to the group members. Requesting a different role for an existing mapping returns 409. Management key required.

  • Write

    Update a SCIM group mapping

    Update a SCIM group mapping role. Management key required.

  • Write

    Start a SCIM directory sync

    Start a SCIM directory sync. Management key required.

  • Destructive

    Delete a SCIM group mapping

    Delete a SCIM group-to-workspace mapping. Management key required.

System One

  • Write

    Submit a System One request

    Sends state and typed questions to a System One model such as Jev and returns its answers. Compatible with the TypeSafe SDKs. Bare System One model IDs such as jev-1.13 and jev-latest are mapped onto the typesafe/ namespace.

Tools

  • Read

    List server tools

    Lists every server tool OpenRouter can run on behalf of a model: accepted tools[].type spellings per API format, the engines behind it with their pricing, and how many endpoints run it natively.

  • Read

    Get a server tool

    One server tool by canonical name or any accepted alias, with the models that run it natively.

Vault

  • Read

    List the connections an intern can use

    Lists the connections in scope for the intern, by the key of their card on the dashboard's Connections tab: github, slack, google, a catalog MCP server such as linear or notion, or mcp: for a custom MCP server.

  • Read

    List the secrets an intern receives

    Lists, one entry per name, the secret the intern's outbound requests receive: its own secrets, secrets from an attached vault, and workspace secrets, including ones stored before workspace-scoped storage.

  • Read

    List intern secrets

    Lists secret metadata stored for one intern. The list includes secrets stored from the dashboard or at provisioning before workspace-scoped storage; where both exist under one name, the one stored through this API is listed.

  • Read

    List workspace secrets

    Lists secret metadata for the workspace of the authenticated API key. The list includes secrets stored from the dashboard or at provisioning before workspace-scoped storage; where both exist under one name, the one stored through this API is listed.

  • Write

    Copy workspace secrets to an intern

    Copies the named workspace secrets into one intern's scope, replacing any intern secret with the same name. Each copy keeps the source value and host bindings. Every name must exist in the workspace scope or the request fails with 404 and nothing is copied.

  • Destructive

    Store an intern secret

    Creates or replaces a secret stored for one intern. The value is encrypted at rest and released only to the exact hostnames in hosts. The response carries metadata only. Writes return 503 while vault writes are disabled for the caller.

  • Destructive

    Delete an intern secret

    Deletes a secret stored for one intern. Returns 204 with no body on success and 404 when the secret does not exist in the selected scope. Writes return 503 while vault writes are disabled for the caller.

  • Destructive

    Store a workspace secret

    Creates or replaces a secret in the workspace of the authenticated API key. The value is encrypted at rest and released only to the exact hostnames in hosts. The response carries metadata only. Writes return 503 while vault writes are disabled for the caller.

  • Destructive

    Delete a workspace secret

    Deletes a secret from the workspace of the authenticated API key. Returns 204 with no body on success and 404 when the secret does not exist in the selected scope. Writes return 503 while vault writes are disabled for the caller.

Video Generation

  • Read

    Poll video generation status

    Returns job status and content URLs when completed

  • Read

    Download generated video content

    Streams the generated video content from the upstream provider

  • Read

    List all video generation models

    Returns a list of all available video generation models and their properties

  • Write

    Submit a video generation request

    Submits a video generation request and returns a polling URL to check status

Workspaces

  • Read

    List workspaces

    List all workspaces for the authenticated user. Management key required.

  • Read

    Get a workspace

    Get a single workspace by ID or slug. Management key required.

  • Read

    List workspace members

    List all members of a workspace. Returns paginated results. For the default workspace, returns all organization members (implicit membership). Management key required.

  • Read

    List workspace budgets

    List all budgets configured for a workspace. Management key required.

  • Read

    Get a workspace budget

    Retrieve the budget for a given interval. Management key required.

  • Write

    Create a workspace

    Create a new workspace for the authenticated user. Management key required.

  • Write

    Update a workspace

    Update an existing workspace by ID or slug. Management key required.

  • Write

    Bulk add members to a workspace

    Add multiple organization members to a workspace. Members are assigned the same role they hold in the organization. Management key required.

  • Write

    Bulk remove members from a workspace

    Remove multiple members from a workspace. Members with active API keys in the workspace cannot be removed. SCIM-managed members cannot be removed; changes must be made in your identity provider. Management key required.

  • Destructive

    Delete a workspace

    Delete an existing workspace. Workspaces with active API keys cannot be deleted; remove the keys first. Deleting the default workspace requires confirmdefaultworkspacedeletion=true.

  • Destructive

    Create or update a workspace budget

    Create or update the budget for a given interval. Budget limits must strictly decrease as the interval narrows (lifetime monthly weekly daily).

  • Destructive

    Delete a workspace budget

    Remove the budget for a given interval. Management key required.

See How connections work for access and permissions, or browse all integrations.

Reference date: October 27, 2026. Openrouter API docs.