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.
No operations match.
See How connections work for access and permissions, or browse all integrations.
Reference date: October 27, 2026. Openrouter API docs.