# Portkey MCP connector

The Portkey connector brings your prompts, prompt versions, collections, labels and partials to Claude, ChatGPT, Cursor and any MCP client, so your team can find, edit and test prompts in plain language once Portkey is connected in Elaichi.

Source: https://elaichi.ai/connectors/portkey/

## Facts

| | |
| --- | --- |
| Application | Portkey |
| Category | Artificial Intelligence |
| AI tools | 239 |
| Authentication | Connects with an API key |
| Needs your own OAuth app | No |
| MCP endpoint | https://api.elaichi.ai/mcp |
| Works with | Claude, ChatGPT, Cursor, any MCP client, and the Elaichi Agent |
| Tools advertised by name | No. 239 tools is past the 30-tool threshold, so clients use `search_tools` and `execute_tool` |

## What you can ask once Portkey is connected

- Which Portkey prompts changed in the last week?
- List Portkey collections and the labels on each.
- Summarize completion volume across our Portkey collections.

## Connect Portkey in Elaichi

This happens once for the organization, before any client is involved.

1. Open Connections, choose Add connection, and pick Portkey.
2. Optionally set Share with, then press Connect.
3. Paste a Portkey API key. One person generates a token in Portkey and pastes it once. Everyone else works through Share with, and never sees it.

Credentials are vaulted and nobody, including the AI, reads them back. The connection becomes a toolbox immediately, so you can curate which Portkey tools are exposed, rename them, or freeze arguments before anyone points a client at it.

## Connect Portkey to Claude

Endpoint: https://api.elaichi.ai/mcp

1. Open Customize, then Connectors.
2. Press Add.
3. Name it, paste the MCP server URL, then Continue.
4. Sign in and approve.

On Team and Enterprise, an Owner adds it once. Everyone else turns it on for themselves.

## Connect Portkey to ChatGPT

Endpoint: https://api.elaichi.ai/mcp

1. Open Plugins, then press the + button.
2. Name it and paste the endpoint into Server URL.
3. Leave Authentication on OAuth, then tick the risk acknowledgement.
4. Press Create, then sign in and approve.

Works on the web today. The plugin directory lives at chatgpt.com/plugins.

## Connect Portkey to Cursor

Endpoint: https://api.elaichi.ai/mcp

1. Open `~/.cursor/mcp.json`.
2. Add the endpoint under `mcpServers`.
3. Reload Cursor, then sign in and approve.

Set up per machine, so repeat it on each computer you work from.

## Connect Portkey to any MCP client

Endpoint: https://api.elaichi.ai/mcp

1. Add the endpoint as a remote MCP server.
2. Sign in and approve.

The Elaichi Agent already has these tools, with nothing to set up.

## What the consent screen decides

Only Read is granted by default, which is not enough to call a Portkey tool. Over MCP there is no trusted place to confirm a write in the moment, so the consent screen is the standing approval rather than a formality. Grant Read and Run tools. Think hard before granting Delete, which reaches into connected apps and cannot be undone.

## What teams do with Portkey through Elaichi

### Find the prompt behind a feature

AI team. Ask which Portkey prompt powers the onboarding assistant and read its current text, without clicking through the dashboard.

### Tighten a prompt after user feedback

Product. Describe the change you want, review the new prompt version, and set it as the default once you are happy with it.

### Keep prompts organized by collection

Platform. Move prompts into the right Portkey collections and add labels such as production or experiment so the catalog stays tidy as it grows.

### Test a prompt with a real completion

Data science. Run a chat completion through Portkey with a sample question and compare the answer against the previous version before rolling it out.

### Check which prompt version is live

Support. Confirm which version of a Portkey prompt customers are hitting right now when an odd answer gets reported, then decide whether to roll back.

### Reuse shared text with prompt partials

Engineering. Create a Portkey partial for the standard safety instructions once, then reference it from every prompt instead of pasting the same paragraph around.

## Frequently asked questions

### How do I connect Portkey to Claude?

Connect Portkey in Elaichi by pasting a Portkey API key, which takes about a minute. Then in Claude open Customize, then Connectors, then Add, and paste https://api.elaichi.ai/mcp. There is no OAuth application to register and no client ID or secret to generate, and Claude will ask you to sign in to Elaichi as yourself.

### Does Portkey work with ChatGPT and Cursor as well as Claude?

Yes. Once Portkey is connected in Elaichi, the same endpoint, https://api.elaichi.ai/mcp, works in Claude, ChatGPT, Cursor, any MCP client and the Elaichi Agent. You connect Portkey once and every client picks it up.

### What can an AI agent actually do with my Portkey data?

With Portkey connected, an agent can list your prompts, read a specific prompt or version, create and edit prompts, set which version is the default, and organize prompts into collections and labels. It can also create partials for shared text and run chat completions through Portkey to test a prompt. Short, concrete asks such as "show me the live version of the refund prompt" work better than long instructions.

### Does connecting Portkey give the AI my whole Portkey workspace?

No. Every call to Portkey runs inside the access of the person who signed in, so the agent can only see the prompts, collections and labels that person can already reach in Portkey. Elaichi can narrow that further, for example to reading only, and it never widens what someone could do on their own.

### Can my team share one Portkey connection?

Yes. One person connects Portkey in Elaichi and shares it with a team, and nobody else ever handles the Portkey API key. Each teammate still signs in to Elaichi as themselves, so the audit log names the actual person behind every prompt change.

### Can I stop an agent from deleting or changing things in Portkey?

Yes. Restrictions in Elaichi work per action, so you can allow reading Portkey prompts and collections while blocking deletes or edits. A blocked action is never advertised to Claude, ChatGPT or any other client, so no prompt, however worded, can reach it.

### What happens to a Portkey connection when someone leaves?

Offboarding that person in Elaichi ends their access to Portkey through every client at once. If they had shared a Portkey connection with a team, it keeps working for everyone else. When you no longer want Portkey connected at all, disconnecting it once in Elaichi removes it from Claude, ChatGPT, Cursor and every other client.

## All 239 Portkey tools

Every tool below is callable through https://api.elaichi.ai/mcp once Portkey is connected, subject to the toolbox it is in and the restrictions on the caller.

- **Create a Portkey chat completion** (Create). Create a chat completion in Portkey by sending a conversation's messages and a model name. Returns: id, choices, created, model, system_fingerprint, object, usage. Required: messages, model.
- **List all Portkey realtimes** (List). Connect to the Portkey Realtime API WebSocket endpoint for streaming realtime sessions. Returns a WebSocket upgrade (101) response on success; the subsequent streaming session follows the provider's realtime protocol. The model query parameter is often required for OpenAI-style realtime sessions.
- **Create a Portkey completion** (Create). Create a text completion in Portkey by sending a prompt to a model via the AI gateway. Returns: id, choices, created, model, system_fingerprint, object, usage. Required: model, prompt.
- **List all Portkey collections** (List). List collections in a Portkey workspace, optionally filtered by name search. Returns each collection with id, slug, name, workspace_id, and parent_collection_id. Required: workspace_id.
- **Create a Portkey collection** (Create). Create a new collection in a Portkey workspace. Returns: id, slug. Required: name.
- **Get single Portkey collection by ID** (Get). Get a single Portkey collection by id. Returns the collection object including id, slug, name, workspace_id, and parent_collection_id. Required: id.
- **Update a Portkey collection by ID** (Update). Update a Portkey collection's name by id. Returns: id. Required: name.
- **Delete a Portkey collection by ID** (Delete). Delete a Portkey collection by id. Returns an empty response on success.
- **List all Portkey labels** (List). List labels in Portkey, optionally filtered by organisation, workspace, or name search. Returns: id, name, description, color_code, organisation_id, workspace_id, is_universal, created_at, last_updated_at, status, updated_at. Max 100 per page.
- **Create a Portkey label** (Create). Create a new label in Portkey. Returns the created label object including id, name, created_at, and updated_at. Required: name.
- **Get single Portkey label by ID** (Get). Get a single Portkey label by id. Returns: id, name, organisation_id, workspace_id, created_at, updated_at. Required: id.
- **Update a Portkey label by ID** (Update). Update an existing Portkey label by id. Returns the updated label object including id, name, created_at, and updated_at. Required: id.
- **Delete a Portkey label by ID** (Delete). Delete a Portkey label by id. Returns an empty 204 response on success. Required: id.
- **List all Portkey prompts** (List). List prompts in Portkey, optionally filtered by collection, workspace, or search term. Returns: id, slug, name, collection_id, model, status, created_at, last_updated_at, object, version_id.
- **Create a Portkey prompt** (Create). Create a new prompt in Portkey. Returns: id, slug, version_id, object. Required: name, collection_id, string, parameters, virtual_key.
- **Get single Portkey prompt by ID** (Get). Get a single Portkey prompt by id or slug. Returns: id, slug, name, collection_id, string, prompt_version, prompt_version_id, prompt_version_status, prompt_version_description, prompt_version_label_id, virtual_key, model, functions, tools, tool_choice, template_metadata, is_raw_template, status, created_at, last_updated_at, version_id, object. Required: id.
- **Update a Portkey prompt by ID** (Update). Update a Portkey prompt's metadata and/or create a new version with updated template content. Set patch to true for partial version updates where omitted fields are inherited from the latest version. Returns: id, slug, prompt_version_id. Required: id.
- **Delete a Portkey prompt by ID** (Delete). Delete a Portkey prompt by id. Returns an empty 204 response on success.
- **List all Portkey prompt versions** (List). List all versions of a prompt in Portkey. Returns: id, slug, version_id, object, name, workspace_id, organisation_id, status, owner_id, updated_by, created_at, last_updated_at, config, format. Required: prompt_id.
- **Update a Portkey prompt version by ID** (Update). Update the label of a specific prompt version in Portkey. Only label_id can be updated; version content (string, parameters, model) is immutable. Returns: id, slug, version_id, object, name. Required: prompt_id, id.
- **Get single Portkey prompt version by ID** (Get). Get a specific version of a prompt in Portkey by version id. Returns: id, slug, name, collection_id, string, prompt_version, prompt_version_id, prompt_version_status, prompt_version_description, prompt_version_label_id, virtual_key, model, functions, tools, tool_choice, template_metadata, is_raw_template, status, created_at, last_updated_at, version_id, object, version_description, total, data.…
- **Portkey prompt make defaults bulk update** (Update). Set a specific version of a Portkey prompt as the default version. Returns an empty 200 response on success. Required: prompt_id, version.
- **List all Portkey prompts partials** (List). List prompt partials in Portkey, optionally filtered by collection. Returns each partial's id, slug, and version_id. Optional: collection_id.
- **Create a Portkey prompts partial** (Create). Create a new prompt partial in Portkey. Returns: id, slug, version_id. Required: name, string. Optional: workspace_id (required for Admin keys), version_description.
- **Get single Portkey prompts partial by ID** (Get). Get a single prompt partial in Portkey by its id or slug. Returns: id, slug, version_id. Required: id.
- **Update a Portkey prompts partial by ID** (Update). Update a prompt partial in Portkey by id. Returns: prompt_partial_version_id. Required: id.
- **Delete a Portkey prompts partial by ID** (Delete). Delete a prompt partial in Portkey by id. Returns an empty 204 response on success. Required: id.
- **List all Portkey partial versions** (List). List all versions of a prompt partial in Portkey. Returns: version_id, version, version_description, string, created_at, updated_at, id, name, workspace_id, slug, organisation_id, status, owner_id, updated_by, last_updated_at, config, format, object. Required: prompt_partial_id.
- **Portkey partial make defaults bulk update** (Update). Set a specific version as the default for a prompt partial in Portkey. Returns an empty object on success confirming the default version was set. Required: prompt_partial_id, version.
- **Create a Portkey prompt completion** (Create). Execute a saved prompt template in Portkey to generate completions with variable substitution. Returns: status, headers, body. Required: prompt_id, variables. Hyperparameters must be passed at the root level alongside variables; max_tokens is deprecated — use max_completion_tokens instead.
- **Create a Portkey prompt render** (Create). Render a Portkey prompt template by substituting its variable values. Returns: success, data. Required: prompt_id, variables. Hyperparameters such as max_completion_tokens and temperature are passed at the root level, not nested under hyperparameters. The max_tokens parameter is deprecated — use max_completion_tokens.
- **List all Portkey guardrails** (List). List guardrails in Portkey, optionally filtered by workspace or organisation. Returns: id, name, slug, organisation_id, workspace_id, status, created_at, last_updated_at, owner_id, updated_by, checks, actions, updated_at. Max 100 per page.
- **Create a Portkey guardrail** (Create). Create a new guardrail in Portkey with specified checks and actions. Returns the created guardrail including id, slug, name, checks, and actions. Required: name, checks, actions.
- **Get single Portkey guardrail by ID** (Get). Get a specific Portkey guardrail by id (UUID or slug with guard_ prefix). Returns: id, slug, name, workspace_id, organisation_id, checks, actions, created_at, updated_at. Required: id.
- **Update a Portkey guardrail by ID** (Update). Update an existing guardrail's name, checks, or actions in Portkey. Returns the updated guardrail object including id, name, slug, checks, actions, organisation_id, and workspace_id. Required: id.
- **Delete a Portkey guardrail by ID** (Delete). Delete an existing guardrail in Portkey by id (UUID or slug). Returns an empty 204 response on success. Required: id.
- **Create a Portkey images generation** (Create). Create an image in Portkey by generating it from a text prompt with a specified model. Returns: b64_json, url, revised_prompt. Required: prompt.
- **Create a Portkey images edit** (Create). Create an image edit in Portkey from an original image and a text prompt describing the desired changes, with an optional mask for targeted edits. Returns: b64_json, url, revised_prompt. Required: image, prompt.
- **Create a Portkey images variation** (Create). Create variations of an existing image in Portkey. Returns the image variation response including created timestamp and a data array of generated image objects. Required: image.
- **Create a Portkey embedding** (Create). Create text embeddings through Portkey's AI Gateway. Returns: index, embedding, object. Required: model, input.
- **Create a Portkey rerank** (Create). Rerank documents by semantic relevance to a query using Portkey's unified interface to reranking models from Cohere, Voyage, Jina, Pinecone, Bedrock, and Azure AI. Returns the rerank response. Required: model, query, documents.
- **Create a Portkey ocr** (Create). Extract text and structured content from documents (PDFs and images) using OCR models in Portkey, supporting providers including Mistral AI and Azure AI Foundry. Returns: pages, model, usage_info. Required: model, document.
- **Create a Portkey audio speech** (Create). Generate speech audio from text via Portkey's AI gateway. Returns a binary audio stream (application/octet-stream) with chunked transfer encoding — write the response body to a file to obtain the audio. Required: model, input, voice.
- **Create a Portkey audio transcription** (Create). Create an audio transcription in Portkey by uploading an audio file with a specified model. Returns: text. Required: file, model.
- **Create a Portkey audio translation** (Create). Create an audio translation in Portkey by submitting an audio file to a speech-to-text model for translation to English. Returns: text. Required: file, model.
- **List all Portkey files** (List). List files in Portkey, optionally filtered by purpose. Returns: id, bytes, created_at, filename, object, purpose, status, status_details. Max 100 per page.
- **Create a Portkey file** (Create). Upload a file to Portkey for use across Assistant, Fine-Tuning, and Batch endpoints. Returns: id, bytes, created_at, filename, object, purpose, status, status_details. Required: file, purpose. Bucket limit 100 GB.
- **Get single Portkey file by ID** (Get). Get information about a specific file in Portkey by id. Returns: id, bytes, created_at, filename, object, purpose, status, status_details. Required: id.
- **Delete a Portkey file by ID** (Delete). Delete a file in Portkey by id. Returns: id, object, deleted. Required: id.
- **List all Portkey contents** (List). Get the contents of a file in Portkey. Returns the raw file content as a string. Required: file_id.
- **List all Portkey fine tuning jobs** (List). List your organization's fine-tuning jobs in Portkey. Returns: id, created_at, error, fine_tuned_model, finished_at, hyperparameters, model, object, organization_id, result_files, status, trained_tokens, training_file, validation_file, integrations, seed, estimated_finish.
- **Create a Portkey fine tuning job** (Create). Create a fine-tuning job in Portkey to fine-tune a provider model. Returns: id, created_at, error, fine_tuned_model, finished_at, hyperparameters, model, object, organization_id, result_files, status, trained_tokens, training_file, validation_file, integrations, seed, estimated_finish. Required: training_file.
- **Get single Portkey fine tuning job by ID** (Get). Get a single fine-tuning job by id in Portkey. Returns: id, created_at, error, fine_tuned_model, finished_at, hyperparameters, model, object, organization_id, result_files, status, trained_tokens, training_file, validation_file, integrations, seed, estimated_finish. Required: id.
- **Portkey fine tuning jobs cancel** (Cancel). Immediately cancel a fine-tuning job in Portkey. Returns: id, created_at, error, fine_tuned_model, finished_at, hyperparameters, model, object, organization_id, result_files, status, trained_tokens, training_file, validation_file, integrations, seed, estimated_finish. Required: job_id.
- **Portkey fine tuning jobs events** (Action). List status update events for a fine-tuning job in Portkey. Returns: id, created_at, level, message, object. Required: job_id.
- **List all Portkey job checkpoints** (List). List checkpoints for a fine-tuning job in Portkey. Returns: id, created_at, fine_tuned_model_checkpoint, step_number, metrics, fine_tuning_job_id, object. Required: fine_tuning_job_id.
- **List all Portkey models** (List). List available models in Portkey, optionally filtered by AI service or provider. Returns: id, created, object, owned_by, slug, canonical_slug. Max 100 per page.
- **Delete a Portkey model by ID** (Delete). Delete a fine-tuned model in Portkey by id. Returns an empty 204 response on success. Required: id.
- **Get single Portkey model by ID** (Get). Get a single model in Portkey by id. Returns: id, created, object, owned_by, slug, canonical_slug, total, data. Required: id.
- **Create a Portkey moderation** (Create). Create a moderation in Portkey to identify potentially harmful content in text and images. Only works with OpenAI's Moderations endpoint currently. Returns: id, model, results. Required: input.
- **List all Portkey assistants** (List). List Portkey assistants ordered by creation date. Returns: id, object, created_at, name, description, model, instructions, tools, tool_resources, metadata, temperature, top_p, response_format.
- **Create a Portkey assistant** (Create). Create a new Portkey assistant with a model and instructions. Returns: id, object, created_at, name, description, model, instructions, tools, tool_resources, metadata, temperature, top_p, response_format. Required: model.
- **Get single Portkey assistant by ID** (Get). Get a single Portkey assistant by id. Returns: id, object, created_at, name, description, model, instructions, tools, tool_resources, metadata, temperature, top_p, response_format. Required: id.
- **Delete a Portkey assistant by ID** (Delete). Delete a Portkey assistant by id. Returns: id, deleted, object. Required: id.
- **Update a Portkey assistant by ID** (Update). Update an existing Portkey assistant by id. Returns: id, object, created_at, name, description, model, instructions, tools, tool_resources, metadata, temperature, top_p, response_format. Required: id.
- **Create a Portkey response** (Create). Create a model response in Portkey by providing a model and input prompt. Returns the response object including id, object, created_at, status, model, and output. Required: model, input. Supports server-sent event streaming when stream is set to true.
- **Get single Portkey response by ID** (Get). Get a Portkey model response by id. Returns the response object including id, object, created_at, status, model, and output. Required: id. Use the include query parameter to retrieve additional output data such as file search results and image URLs.
- **Delete a Portkey response by ID** (Delete). Delete a Portkey model response by id. Returns an empty 200 response on success. Required: id.
- **List all Portkey response input items** (List). List input items for a Portkey response by response_id. Returns each input item including its id, type, and type-specific attributes. Required: response_id. Max 100 per page.
- **Create a Portkey thread** (Create). Create a new thread in Portkey. Returns the created thread object including id, object, created_at, metadata, and tool_resources. Accepts an optional messages array to pre-populate the thread with user messages.
- **Get single Portkey thread by ID** (Get). Get a single thread in Portkey by id. Returns: id, object, created_at, tool_resources, metadata. Required: id.
- **Delete a Portkey thread by ID** (Delete). Delete a thread in Portkey by id. Returns: id, deleted, object. Required: id.
- **Update a Portkey thread by ID** (Update). Update a thread in Portkey by id. Only the metadata field can be modified. Returns the updated thread object including id, object, created_at, metadata, and tool_resources. Required: id.
- **List all Portkey thread messages** (List). List messages for a given Portkey thread. Returns each message with id, object, created_at, thread_id, role, content, attachments, and metadata. Required: thread_id.
- **Create a Portkey thread message** (Create). Create a message in a Portkey thread. Returns the created message including id, object, created_at, thread_id, role, content, attachments, and metadata. Required: thread_id, role, content.
- **Delete a Portkey thread message by ID** (Delete). Delete a message from a Portkey thread. Returns: id, deleted, object. Required: thread_id, id.
- **Get single Portkey thread message by ID** (Get). Get a single message from a Portkey thread by id. Returns the message including id, object, created_at, thread_id, role, content, attachments, and metadata. Required: thread_id, id.
- **Update a Portkey thread message by ID** (Update). Modify a message in a Portkey thread, typically updating its metadata. Returns the updated message including id, object, created_at, thread_id, role, content, attachments, and metadata. Required: thread_id, id.
- **Create a Portkey threads run** (Create). Create a thread and run it in one request in Portkey. Returns the run object including id, object, status, assistant_id, thread_id, model, created_at, and expires_at. Required: assistant_id, thread.
- **List all Portkey thread runs** (List). List runs belonging to a Portkey thread, ordered by creation date. Returns each run with id, object, created_at, assistant_id, thread_id, status, model, tools, metadata, and usage. Required: thread_id.
- **Create a Portkey thread run** (Create). Create a run on a Portkey thread using an existing assistant. Returns the created run object including id, status, assistant_id, thread_id, model, and created_at. Required: thread_id, assistant_id.
- **Portkey thread runs cancel** (Cancel). Cancel a Portkey run that is currently in_progress. Returns the run object including id, status, assistant_id, thread_id, and model. Required: thread_id, run_id.
- **Get single Portkey thread run by ID** (Get). Get a single Portkey run by id within a thread. Returns the run object including id, status, assistant_id, thread_id, model, created_at, tools, and usage. Required: thread_id, id.
- **Update a Portkey thread run by ID** (Update). Update a Portkey run's metadata by id within a thread. Returns the updated run object including id, status, assistant_id, thread_id, model, and metadata. Required: thread_id, id.
- **Create a Portkey run submit tool output** (Create). Submit tool call outputs for a Portkey run with status 'requires_action'. All outputs must be submitted in a single request. Returns the updated run object including id, status, assistant_id, thread_id, model, and created_at. Required: thread_id, run_id, tool_outputs.
- **List all Portkey run steps** (List). List run steps belonging to a specific run in Portkey. Returns: id, object, created_at, assistant_id, thread_id, run_id, type, status, step_details, last_error, expired_at, cancelled_at, failed_at, completed_at, metadata, usage. Required: thread_id, run_id. Max 100 per page; default 20.
- **Get single Portkey run step by ID** (Get). Get a single run step by id in Portkey. Returns: id, object, created_at, assistant_id, thread_id, run_id, type, status, step_details, last_error, expired_at, cancelled_at, failed_at, completed_at, metadata, usage. Required: thread_id, run_id, id.
- **List all Portkey vector stores** (List). List Portkey vector stores ordered by creation date. Returns each store with id, object, created_at, name, bytes, and file_counts. Max 100 per page.
- **Create a Portkey vector store** (Create). Create a new Portkey vector store. Returns the created vector store object including id, object, created_at, name, bytes, and file_counts.
- **Get single Portkey vector store by ID** (Get). Get a single Portkey vector store by id. Returns the full vector store object including id, object, created_at, name, bytes, and file_counts. Required: id.
- **Delete a Portkey vector store by ID** (Delete). Delete a Portkey vector store by id. Returns: id, deleted, object. Required: id.
- **Update a Portkey vector store by ID** (Update). Update a Portkey vector store by id. Returns the updated vector store object including id, object, created_at, name, bytes, and file_counts. Required: id.
- **List all Portkey vector store files** (List). List vector store files in Portkey. Returns each file's id, object, created_at, usage_bytes, vector_store_id, status, and last_error. Required: vector_store_id. Max 100 per page.
- **Create a Portkey vector store file** (Create). Create a vector store file in Portkey by attaching an existing File to a vector store. Returns: id, object, usage_bytes, created_at, vector_store_id, status, last_error, chunking_strategy. Required: vector_store_id, file_id.
- **Delete a Portkey vector store file by ID** (Delete). Delete a vector store file in Portkey, removing it from the vector store without deleting the underlying File. Returns: id, deleted, object. Required: vector_store_id, id.
- **Get single Portkey vector store file by ID** (Get). Get a single vector store file in Portkey by id. Returns: id, object, usage_bytes, created_at, vector_store_id, status, last_error, chunking_strategy, export_settings. Required: vector_store_id, id.
- **Create a Portkey vector store file batch** (Create). Create a vector store file batch in Portkey by providing a list of file IDs to add to the vector store. Returns: id, object, created_at, vector_store_id, status, file_counts. Required: vector_store_id, file_ids.
- **Portkey vector store file batches cancel** (Cancel). Cancel a vector store file batch in Portkey, attempting to stop processing of files in the batch as soon as possible. Returns: id, object, created_at, vector_store_id, status, file_counts. Required: vector_store_id, batch_id.
- **Get single Portkey vector store file batch by ID** (Get). Retrieve a specific vector store file batch in Portkey by its batch ID. Returns: id, object, created_at, vector_store_id, status, file_counts, export_settings. Required: vector_store_id, id.
- **List all Portkey file batche files** (List). List vector store files within a file batch in Portkey. Returns each file's id, object, created_at, and vector_store_id. Required: vector_store_id, batch_id. Filter by file status (in_progress, completed, failed, cancelled) and sort order by created_at are supported.
- **List all Portkey batches** (List). List your organization's batches in Portkey. Returns: id, object, endpoint, errors, input_file_id, completion_window, status, output_file_id, error_file_id, created_at, in_progress_at, expires_at, finalizing_at, completed_at, failed_at, expired_at, cancelling_at, cancelled_at, request_counts, metadata. Max 100 per page.
- **Create a Portkey batch** (Create). Create and execute a batch in Portkey from an uploaded file of requests. Returns the created batch including id, status, input_file_id, endpoint, completion_window, and created_at. Required: input_file_id, endpoint, completion_window.
- **Get single Portkey batch by ID** (Get). Get a single batch in Portkey by id. Returns: id, object, endpoint, errors, input_file_id, completion_window, status, output_file_id, error_file_id, created_at, in_progress_at, expires_at, finalizing_at, completed_at, failed_at, expired_at, cancelling_at, cancelled_at, request_counts, metadata. Required: id.
- **Portkey batches cancel** (Cancel). Cancel an in-progress batch in Portkey. The batch enters cancelling status for up to 10 minutes before becoming cancelled, with partial results available in the output file. Returns the batch including id, status, input_file_id, endpoint, completion_window, created_at. Required: batche_id.
- **List all Portkey batche outputs** (List). Retrieve the output of a completed Portkey batch as a binary stream (application/octet-stream). Required: batch_id.
- **List all Portkey configs** (List). List all Portkey configs. Returns: id, name, slug, organisation_id, workspace_id, status, owner_id, updated_by, created_at, last_updated_at.
- **Create a Portkey config** (Create). Create a new Portkey config. Returns: id, version_id. Required: name, config.
- **Get single Portkey config by ID** (Get). Get a single Portkey config by id. Returns the config object including retry, cache, strategy, and targets settings. Required: id.
- **Update a Portkey config by ID** (Update). Update a Portkey config by id. Returns: version_id. Required: id.
- **Delete a Portkey config by ID** (Delete). Delete a Portkey config by id. Returns an empty 204 response on success. Required: id.
- **List all Portkey config versions** (List). List all versions of a Portkey config by its slug. Returns: id, name, workspace_id, slug, organisation_id, status, owner_id, updated_by, created_at, last_updated_at, config, format, type, version_id, object. Required: slug.
- **Create a Portkey feedback** (Create). Create new feedback for a Portkey interaction or trace. Returns a feedback response confirming successful submission. Required: trace_id, value. Value must be an integer between -10 and 10; weight defaults to 1.0.
- **Update a Portkey feedback by ID** (Update). Update existing feedback in Portkey by id. Returns a feedback response confirming successful update. Required: id, value.
- **List all Portkey integrations** (List). List all integrations in Portkey, optionally filtered by workspace or integration scope. Returns: id, organisation_id, ai_provider_id, name, status, created_at, last_updated_at, slug, description, object, note.
- **Create a Portkey integration** (Create). Create a new Portkey integration by providing the AI provider and credentials. Returns: id. Required: name, ai_provider_id, key.
- **Get single Portkey integration by ID** (Get). Get a single Portkey integration by id. Returns: id, slug, name, ai_provider_id, note. Required: id.
- **Update a Portkey integration by ID** (Update). Update a Portkey integration's name or note by id. Returns: id. Required: id.
- **Delete a Portkey integration by ID** (Delete). Delete a Portkey integration by id. Returns: id. Required: id.
- **List all Portkey integration models** (List). List all models available for a specific Portkey integration, including configuration and pricing details. Returns: id, slug, canonical_slug, object. Required: slug.
- **Portkey integration models bulk update** (Update). Bulk update model access, pricing configuration, and settings for multiple models in a Portkey integration. Can enable/disable models and configure custom pricing. Returns: object, total, data. Required: slug, models.
- **Portkey integration models bulk delete** (Delete). Bulk delete multiple custom models from a Portkey integration by their model slugs. Returns a success confirmation object on successful deletion. Required: slug, slugs.
- **List all Portkey integration workspaces** (List). List workspace access configurations for a Portkey integration by slug. Returns: workspace_id, usage_limits, rate_limits for each workspace with access to the integration. Required: slug.
- **Portkey integration workspaces bulk update** (Update). Bulk update workspace access for a Portkey integration. Updates workspace access permissions, usage limits, and rate limits for an integration, supporting both global workspace access and per-workspace settings. Returns the updated workspace access configuration object. Required: slug.
- **List all Portkey providers** (List). List all providers in Portkey. Returns: name, integration_id, note, status, usage_limits, reset_usage, created_at, slug, rate_limits, expires_at, object, id, workspace_id. Max 100 per page.
- **Create a Portkey provider** (Create). Create a new provider in Portkey. Returns: id, slug, name, integration_id, workspace_id, note, usage_limits, rate_limits, expires_at. Required: name, integration_id.
- **Get single Portkey provider by ID** (Get). Get a single provider by id in Portkey. Returns: id, slug, name, integration_id, workspace_id, note, usage_limits, rate_limits, expires_at. Required: id.
- **Update a Portkey provider by ID** (Update). Update a Portkey provider by id, modifying fields such as name, note, usage limits, rate limits, expiry, and reset usage. Returns: id, slug. Required: id.
- **Delete a Portkey provider by ID** (Delete). Delete a Portkey provider by id. Returns an empty 204 response on success. Required: id.
- **List all Portkey virtual keys** (List). List all Portkey virtual keys. Returns: name, note, status, usage_limits, reset_usage, created_at, slug, model_config, rate_limits, expires_at, secret_mappings, object, id, provider, key, workspace_id, apiVersion, resourceName, deploymentName, deploymentConfig, last_updated_at.
- **Create a Portkey virtual key** (Create). Create a Portkey virtual key for a given AI provider. Returns: slug.
- **Get single Portkey virtual key by ID** (Get). Get a single Portkey virtual key by id. Returns: id, slug, name, provider, key, note, workspace_id, apiVersion, resourceName, deploymentName, deploymentConfig, usage_limits, rate_limits, expires_at, secret_mappings, created_at, last_updated_at. Required: id.
- **Update a Portkey virtual key by ID** (Update). Update a Portkey virtual key by id. Returns: id, slug, name, provider, key, note, workspace_id, apiVersion, resourceName, deploymentName, deploymentConfig, usage_limits, rate_limits, expires_at, secret_mappings, created_at, last_updated_at. Required: id.
- **Delete a Portkey virtual key by ID** (Delete). Delete a Portkey virtual key by id. Returns an empty 204 response on success. Required: id.
- **List all Portkey users invites** (List). List all user invites in Portkey. Returns: object, id, email, role, created_at, expires_at, accepted_at, status, invited_by, workspaces. Filter by role, email, or status.
- **Create a Portkey users invite** (Create). Send a user invite to join your Portkey organization. Returns the created invite object including its id, email, role, status, created_at, expires_at, invited_by, and workspaces. Required: email.
- **Get single Portkey users invite by ID** (Get). Get a single Portkey user invite by id. Returns: object, id, email, role, created_at, expires_at, accepted_at, status, invited_by, workspaces. Required: id.
- **Delete a Portkey users invite by ID** (Delete). Delete a Portkey user invite by id. Returns an empty response on success. Required: id.
- **Create a Portkey invite resend** (Create). Resend an invite to a user in your Portkey organization. Returns: inviteLink. Required: invite_id.
- **List all Portkey admin users** (List). List Portkey admin users with optional role and email filters. Returns: object, id, first_name, last_name, role, email, created_at, last_updated_at, workspace_ids.
- **Get single Portkey admin user by ID** (Get). Get a single Portkey admin user by id. Returns: object, id, first_name, last_name, role, email, created_at, last_updated_at, workspace_ids, expires_at, accepted_at, status, invited_by, workspaces. Required: id.
- **Update a Portkey admin user by ID** (Update). Update a Portkey admin user's role by id. Returns the updated user object including object, id, first_name, last_name, role, email, created_at, last_updated_at, and workspace_ids. Required: id.
- **Delete a Portkey admin user by ID** (Delete). Remove a Portkey admin user by id. Returns an empty response on success. Required: id.
- **List all Portkey workspace users** (List). List members of a Portkey workspace, optionally filtered by role or email. Returns: object, id, first_name, last_name, org_role, role, created_at, last_updated_at, status, workspace_id, email, scopes, settings, expires_at, accepted_at, invited_by, workspaces. Required: workspace_id.
- **Create a Portkey workspace user** (Create). Add one or more existing Portkey users as members of a workspace, each with a specified role. Returns an empty response body on success. Required: workspace_id, users.
- **Update a Portkey workspace user by ID** (Update). Update a Portkey workspace member's role by id. Returns an empty response body on success. Required: workspace_id, id, role.
- **Delete a Portkey workspace user by ID** (Delete). Remove a member from a Portkey workspace by id. Returns an empty 204 response on success. Required: workspace_id, id.
- **Get single Portkey workspace user by ID** (Get). Get a single Portkey workspace member by id. Returns: object, id, first_name, last_name, org_role, role, created_at, last_updated_at, status, workspace_id, email, scopes, settings. Required: workspace_id, id.
- **List all Portkey admin workspaces** (List). List Portkey workspaces with optional filtering by name, exact name, or status. Returns: id, slug, name, description, created_at, last_updated_at, defaults, usage_limits, rate_limits, object.
- **Create a Portkey admin workspace** (Create). Create a new workspace in Portkey with optional defaults, users, usage limits, and rate limits. Returns: id, name, description, created_at, last_updated_at, object.
- **Get single Portkey admin workspace by ID** (Get). Get a single Portkey workspace by id, including its member users. Returns: id, name, description, created_at, last_updated_at, object, users, email, role, expires_at, accepted_at, status, invited_by, workspaces. Required: id.
- **Update a Portkey admin workspace by ID** (Update). Update a Portkey workspace by id, including name, description, defaults, usage limits, and rate limits. Returns: id, name, description, created_at, last_updated_at, object, email, role, expires_at, accepted_at, status, invited_by, workspaces. Required: id.
- **Delete a Portkey admin workspace by ID** (Delete). Delete a Portkey workspace by id. Returns an empty 200 response on success. Required: id.
- **List all Portkey SCIM workspaces** (List). List all SCIM group to workspace mappings in Portkey, optionally filtered by workspace, SCIM group, or role. Returns: id, workspace_id, scim_group, scim_group_id, role, name, created_at, last_updated_at, object.
- **Create a Portkey SCIM workspace** (Create). Create a SCIM group to workspace mapping in Portkey. Either reference an existing SCIM group by ID or provide a group name to pre-create it before the IdP provisions it. Returns: id, workspace_id, scim_group, role, scim_group_id. Required: workspace_id, role. Either scim_group_id or scim_group_name must be provided.
- **Delete a Portkey SCIM workspace by ID** (Delete). Delete a SCIM group to workspace mapping in Portkey by id. Archives the mapping without deleting the SCIM group or workspace. Returns: success. Required: id.
- **List all Portkey mcp integrations** (List). List MCP Integrations in Portkey, optionally filtered by type, workspace_id, or a search term. Returns each integration with id, slug, name, url, auth_type, and transport.
- **Create a Portkey mcp integration** (Create). Create a new MCP Integration in Portkey. Returns the created integration with id, name, url, auth_type, and transport. Required: name, url, auth_type, transport. Either organisation_id or workspace_id must also be provided.
- **Get single Portkey mcp integration by ID** (Get). Get a single Portkey MCP Integration by id. Returns: id, slug, name, url, auth_type, transport. Required: id.
- **Update a Portkey mcp integration by ID** (Update). Update a Portkey MCP Integration by id. Returns the updated integration with id, name, url, auth_type, and transport. Required: id.
- **Delete a Portkey mcp integration by ID** (Delete). Delete a Portkey MCP Integration by id. Returns the deleted integration object with id, name, url, auth_type, and transport. Required: id.
- **List all Portkey mcp integration workspaces** (List). List workspaces associated with a Portkey MCP integration. Returns: id, name, description, created_at, last_updated_at, object. Required: mcp_integration_id. The optional version parameter switches the response shape from a legacy workspaces array to a data/total paginated shape.
- **Portkey mcp integration workspaces bulk update** (Update). Bulk update workspace access for a Portkey MCP integration. Returns a JSON object with the update result. Required: mcp_integration_id.
- **List all Portkey mcp integration capabilities** (List). List MCP integration capabilities in Portkey, optionally filtered by capability type. Returns: name, type, title, description, icons, enabled, created_at, last_updated_at, input_schema, output_schema, execution, annotations, arguments, uri, uri_template, mime_type, size. Required: mcp_integration_id.
- **Portkey mcp integration capabilities bulk update** (Update). Bulk update MCP integration capabilities in Portkey by submitting update payloads for multiple capabilities at once. Returns the bulk update result object. Required: mcp_integration_id.
- **List all Portkey mcp integration metadata** (List). Get the metadata key-value pairs attached to a Portkey MCP integration. Returns: _user, environment, feature, request_id. Required: mcp_integration_id.
- **List all Portkey mcp servers** (List). List MCP Servers for a workspace in Portkey. Returns: id, organisation_id, name, description, status, created_at, owner_id, slug, workspace_id, mcp_integration_id, mcp_integration_slug, mcp_integration_url, auth_type, workspace_name, workspace_slug, url. Max 100 per page.
- **Create a Portkey mcp server** (Create). Create a new MCP Server in Portkey as a workspace instance of an MCP Integration. Returns: id, slug, name, mcp_integration_id. Required: name, mcp_integration_id.
- **Get single Portkey mcp server by ID** (Get). Get a single MCP Server by id in Portkey. Returns: id, name, mcp_integration_id. Required: id.
- **Update a Portkey mcp server by ID** (Update). Update an MCP Server by id in Portkey. Returns: id. Required: id.
- **Delete a Portkey mcp server by ID** (Delete). Delete an MCP Server by id in Portkey. Returns: id.
- **Create a Portkey mcp server test** (Create). Test connectivity to an MCP server in Portkey by verifying its integration URL. Returns an opaque response whose fields are determined upstream by the Portkey API. Required: mcp_server_id.
- **List all Portkey mcp server capabilities** (List). List capabilities for a Portkey MCP Server, optionally filtered by capability type. Returns: name, type, title, description, icons, enabled, integration_enabled, input_schema, output_schema, execution, annotations, arguments, uri, uri_template, mime_type, size. Required: mcp_server_id.
- **Portkey mcp server capabilities bulk update** (Update). Bulk update capabilities for a Portkey MCP server, enabling or disabling tools, prompts, resources, and resource templates. Returns the bulk update response. Required: mcp_server_id.
- **List all Portkey mcp server user acceses** (List). List user access records for a specific MCP server in Portkey. Returns: user_id, first_name, last_name, enabled, has_override, connection_status, object, id, role, email, created_at, last_updated_at, expires_at, accepted_at, status, invited_by, workspaces. Required: mcp_server_id.
- **Portkey mcp server user acceses bulk update** (Update). Bulk update user access records for a specific MCP server in Portkey. Returns: success. Required: mcp_server_id.
- **List all Portkey mcp server connections** (List). List MCP Server Connections for a specific MCP server in Portkey. Returns: user_id, connected, created_at, last_updated_at, id, workspace_id, mcp_server_id, updated_at. Required: mcp_server_id. Optionally filter by user_id or workspace_id.
- **Portkey mcp server connections bulk delete** (Delete). Delete an MCP server connection in Portkey, disconnecting a user from the specified MCP server. Returns: success. Required: mcp_server_id. user_id is required when using a service API key; optional with a user API key.
- **Create a Portkey log** (Create). Create one or more custom log entries in Portkey by submitting request and response payloads with optional metadata. Returns: id, created_at. Accepts a single log object or an array of log objects.
- **Get single Portkey log by ID** (Get). Get a specific Portkey log by id. Returns: _id, request, response, organisation_id, created_at, metrics, id. Required: id. When path_format is v2, created_at is also required.
- **Get single Portkey logs export by ID** (Get). Get a specific Portkey logs export by id. Returns: id, organisation_id, filters, requested_data, status, description, created_at, last_updated_at, created_by, workspace_id, object. Required: id.
- **Update a Portkey logs export by ID** (Update). Update a Portkey logs export by id. Returns: id, total, object, workspace_id, filters, requested_data. Required: id, filters.
- **List all Portkey logs exports** (List). List all Portkey logs exports, optionally filtered by workspace. Returns each export with id, organisation_id, filters, requested_data, status, description, created_at, last_updated_at, created_by, workspace_id, object, error. Max 100 per page.
- **Create a Portkey logs export** (Create). Create a Portkey log export job by specifying filters and requested data fields. Returns: id, total, object, workspace_id, filters, requested_data. Required: filters, requested_data. Up to 50,000 logs per export job.
- **Portkey logs exports start** (Start). Start processing a Portkey logs export job by export_id. Returns: message, object. Required: export_id.
- **Portkey logs exports cancel** (Cancel). Cancel log export. Returns: message, object. Required: export_id.
- **List all Portkey export downloads** (List). Download a completed Portkey log export by retrieving its signed download URL for the JSONL export file. Returns: signed_url. Required: export_id. The export job must be completed before calling this endpoint; up to 50,000 logs per export job.
- **List all Portkey audit logs** (List). List Portkey audit logs filtered by time range and organisation. Returns: id, request_id, method, uri, user_id, user_type, workspace_id, organisation_id, response_status_code, resource_type, action, client_ip, country, created_at. Required: start_time, end_time, organisation_id. Max 100 per page.
- **Create a Portkey API key** (Create). Create a Portkey API key for a given type and sub-type, with scopes and optional rotation or usage-limit policies. Returns: id, key, object. Required: type, sub_type, name, scopes.
- **List all Portkey API keys** (List). List all Portkey API keys, optionally filtered by workspace. Returns each key's id, key, and object.
- **Get single Portkey API key by ID** (Get). Get a single Portkey API key by id. Returns: id, key, object. Required: id.
- **Update a Portkey API key by ID** (Update). Update a Portkey API key's metadata, scopes, rate limits, rotation policy, or usage limits by id. The key type and user_id cannot be changed after creation. Returns: id, object. Required: id.
- **Delete a Portkey API key by ID** (Delete). Delete a Portkey API key by id. Returns an empty response on success. Required: id.
- **Create a Portkey API key rotate** (Create). Rotate an existing Portkey API key, generating a new key value while the previous key remains valid during a transition period. Returns: id, key, key_transition_expires_at, object. Required: api_key_id.
- **List all Portkey policies usage limits** (List). List Portkey usage limits policies with optional status and type filtering. Returns: id, name, conditions, group_by, type, credit_limit, alert_threshold, periodic_reset, periodic_reset_days, next_usage_reset_at, last_reset_at, status, workspace_id, organisation_id, created_at, last_updated_at, value_key_usage_map.
- **Create a Portkey policies usage limit** (Create). Create a Portkey usage limits policy to control total cost or token usage over a period. Returns: id, name, type, credit_limit, alert_threshold, periodic_reset, conditions, group_by, created_at. Required: conditions, group_by, type, credit_limit.
- **Get single Portkey policies usage limit by ID** (Get). Get a single Portkey usage limits policy by id. Returns: id, name, type, credit_limit, alert_threshold, periodic_reset, conditions, group_by, created_at. Required: id.
- **Update a Portkey policies usage limit by ID** (Update). Update an existing Portkey usage limits policy by id. Returns: id, name, type, credit_limit, alert_threshold, periodic_reset, conditions, group_by, created_at. Required: id.
- **Delete a Portkey policies usage limit by ID** (Delete). Archive (soft delete) a Portkey usage limits policy by id. Returns an empty 204 response on success. Required: id.
- **List all Portkey usage limit entities** (List). List entities tracked by a Portkey usage limits policy with their current usage. Returns: id, value_key, current_usage, status. Required: policy_usage_limits_id.
- **Portkey usage limit entities bulk update** (Update). Reset the current usage for a specific entity in a Portkey usage limits policy. Returns an empty object on success. Required: policy_usage_limits_id, entity_id.
- **List all Portkey policies rate limits** (List). List all rate limits policies in Portkey with optional filtering by status, type, unit, and target. Returns: id, name, conditions, group_by, type, unit, value, status, workspace_id, organisation_id, created_at, last_updated_at, target, updated_at.
- **Create a Portkey policies rate limit** (Create). Create a new rate limits policy in Portkey to control the rate of requests or tokens consumed per minute, hour, or day. Returns: id, name, conditions, group_by, type, unit, value, created_at, updated_at. Required: name, type, unit, value.
- **Get single Portkey policies rate limit by ID** (Get). Get a single rate limits policy by id in Portkey. Returns: id, name, conditions, group_by, type, unit, value, created_at, updated_at. Required: id.
- **Update a Portkey policies rate limit by ID** (Update). Update an existing rate limits policy in Portkey by id, such as changing the rate limit value or unit. Returns: id, name, conditions, group_by, type, unit, value, created_at, updated_at. Required: id.
- **Delete a Portkey policies rate limit by ID** (Delete). Delete a rate limits policy in Portkey by id. Returns an empty response on success. Required: id.
- **List all Portkey graphs requests** (List). Get the requests analytics graph from Portkey, showing request volume across time buckets. Returns: summary, data_points, object, request_timeout, retry, provider. Supports optional filters by time range, cost, tokens, status code, virtual keys, configs, API keys, metadata, AI model, trace ID, span ID, and prompt slug.
- **List all Portkey graphs costs** (List). Get a Portkey cost analytics graph showing cost trends over time. Returns: summary, data_points, object. All parameters are optional filters for narrowing the cost graph by time range, cost, token counts, status codes, virtual keys, configs, API keys, metadata, AI model, trace ID, span ID, and prompt slug.
- **List all Portkey graphs latencies** (List). Get the latency analytics graph in Portkey, returning average and percentile (p50, p90, p99) latency metrics as time-series data points. Returns: summary, data_points, object. All query parameters are optional filters.
- **List all Portkey graphs tokens** (List). Get the tokens analytics graph in Portkey, showing token usage over time. Returns: summary, data_points, object, budget_tokens. All query parameters are optional filters including time range, cost, token counts, status code, virtual keys, configs, API keys, metadata, AI model, trace ID, span ID, and prompt slug.
- **List all Portkey graphs users** (List). Get users graph. Returns unique user count across different time buckets. Returns: summary, data_points, object. Required: workspace_slug, time_of_generation_min, time_of_generation_max.
- **List all Portkey users requests** (List). Get the Portkey users requests analytics graph showing average requests per user across different time buckets. Returns: summary, data_points, object, total, data.
- **List all Portkey graphs errors** (List). Get the Portkey errors graph showing error counts across time buckets. Returns: summary, data_points, object.total, data_points (each with timestamp and total per bucket), and object type. Supports optional filtering by time range, cost, tokens, status code, virtual keys, configs, API keys, metadata, AI model, trace ID, span ID, and prompt slug.
- **List all Portkey errors rates** (List). Get the percentage error rate time series graph in Portkey. Returns: summary, data_points, object. Supports optional filters including workspace, time range, cost, tokens, status code, virtual keys, configs, metadata, AI model, trace ID, span ID, and prompt slug.
- **List all Portkey errors stacks** (List). Get a status code wise stacked error graph in Portkey. Returns: summary, data_points, object. All filter parameters are optional.
- **List all Portkey errors status codes** (List). Get a status-code-grouped error graph in Portkey analytics. Returns: summary, data_points, object. All query parameters are optional filters.
- **List all Portkey requests rescueds** (List). Get the Portkey rescued requests graph showing requests saved by retry and fallback strategies over time. Returns: summary, data_points, object, request_timeout, retry, provider. Required: workspace_slug, time_of_generation_min, time_of_generation_max.
- **List all Portkey cache hit rates** (List). Get cache hit rate graph data in Portkey. Returns: summary, data_points, object, provider, cache, retry. Supports optional filtering by time range, cost, tokens, status code, virtual keys, configs, API key IDs, metadata, AI model, trace/span IDs, and prompt slug.
- **List all Portkey cache latencies** (List). Get the cache hit latency graph from Portkey analytics. Returns: summary, data_points, object, provider, cache, retry. Supports filtering by time range, cost, tokens, status code, virtual keys, configs, metadata, trace ID, and more.
- **List all Portkey graphs feedbacks** (List). Get the Portkey feedbacks analytics graph with time-bucketed feedback counts. Returns: summary, data_points, object. Supports optional filtering by workspace, time range, cost, token counts, status code, weighted feedback, virtual keys, configs, API keys, metadata, AI model, trace ID, span ID, and prompt slug.
- **List all Portkey feedbacks scores** (List). Get a score-wise feedbacks distribution graph in Portkey showing how feedback counts are distributed across each feedback score value. Returns: summary, data_points, object.
- **List all Portkey feedbacks weighteds** (List). List weighted feedback graph data from Portkey, where weighted feedback is calculated as value multiplied by score. Returns: summary, data_points, object. Supports optional filters including time of generation range, total units, cost, prompt/completion tokens, status code, weighted feedback range, virtual keys, configs, API key IDs, metadata, AI model, trace ID, span ID, and prompt slug.
- **List all Portkey feedbacks AI models** (List). Get a Portkey analytics graph of feedbacks grouped by AI model. Returns: summary, data_points, object, total, data. Required: workspace_slug, time_of_generation_min, time_of_generation_max.
- **List all Portkey summary caches** (List). Get cache summary analytics data for a selected time period in Portkey. Returns a summary object including hits, avg_latency, total_requests, and cache_speedup, along with an object type identifier. Required: workspace_slug, time_of_generation_min, time_of_generation_max.
- **List all Portkey groups users** (List). List Portkey analytics data grouped by end user, showing request counts and costs per user. Returns: user, requests, cost, object, total, data. Each data item contains the user identifier, total requests, and cost in cents. Required: workspace_slug, time_of_generation_min, time_of_generation_max.
- **List all Portkey groups AI models** (List). Get AI model grouped analytics data from Portkey, showing request counts aggregated per AI model. Returns: ai_model, requests, object, total, data. Required: workspace_slug, time_of_generation_min, time_of_generation_max.
- **List all Portkey groups providers** (List). List Portkey analytics data grouped by provider (virtual key). Returns: provider, requests, object. Use the columns parameter to choose which metrics to include.
- **Get single Portkey groups metadatum by ID** (Get). Get Portkey analytics data grouped by a specific metadata key, returning a list of analytics-group objects. Returns: metadata_value, requests, cost, avg_tokens, avg_weighted_feedback, requests_with_feedback, last_seen, object. Required: id (the metadata key).
- **List all Portkey model configs pricings** (List). Get model pricing configuration in Portkey for a specific provider and model. Returns pay_as_you_go token prices, calculate formulas, and currency. Required: provider, model. Prices are in USD cents per token.
- **List all Portkey secret references** (List). List all Portkey secret references, optionally filtered by manager type, tags, or name. Returns: id, name, slug, manager_type, status, created_at, last_updated_at, object, secret_path. Max 100 per page.
- **Create a Portkey secret reference** (Create). Create a new Portkey secret reference linking to an external secret manager. Returns: id, slug, object. Required: name, manager_type, auth_config, secret_path. allow_all_workspaces and allowed_workspaces are mutually exclusive.
- **Get single Portkey secret reference by ID** (Get). Get a single Portkey secret reference by UUID or slug. Returns: id, slug, object, name, manager_type, secret_path. Required: id.
- **Update a Portkey secret reference by ID** (Update). Update a Portkey secret reference by UUID or slug. Returns: id, object, name. Required: id.
- **Delete a Portkey secret reference by ID** (Delete). Delete a Portkey secret reference by UUID or slug. Returns an empty 204 response on success. Required: id. Cannot delete a reference that is in use by integrations or virtual keys.
- **List all Portkey deployments** (List). List Portkey gateway deployments with optional filters for status, type, workspace, and name search. Returns: id, name, slug, type, status, is_default, connection_status, created_by, created_at, last_updated_at, last_synced_at, last_resynced_at, object, auth_settings, client_auth, workspace_slug, organisation_id, updated_at. Max 100 per page.
- **Create a Portkey deployment** (Create). Register a self-hosted Portkey gateway deployment with the control plane. Issues a client_auth token returned in full only in this response. Returns: id, type, created_at, updated_at. Required: name.
- **Get single Portkey deployment by ID** (Get). Get a Portkey gateway deployment by id (UUID or 'self' when authenticated with the Gateway's own client_auth token). Returns: id, name, type, status, auth_settings, client_auth, is_default, workspace_slug, organisation_id, created_at, updated_at. Required: id.
- **Update a Portkey deployment by ID** (Update). Update a Portkey gateway deployment by id, including name and auth_settings. Rotating client_auth via this endpoint returns the new token in full. Returns: id, name, type, created_at, updated_at. Required: id.
- **Delete a Portkey deployment by ID** (Delete). Archive (soft-delete) a Portkey gateway deployment by id. The record is soft-deleted, not permanently removed. Returns: id, name, type, created_at, updated_at. Required: id.
- **List all Portkey deployment pings** (List). Ping a Portkey Gateway deployment to run a two-way connectivity check — an outbound health call to the Gateway and an inbound verify-ping callback. Returns: status, gateway_base_url, outbound, inbound, object, version. Required: deployment_id. The inbound check waits up to 10 seconds for the Gateway to call back; returns 400 if no gateway_base_url is configured for the deployment.