Portkey

Portkey Assistants API

Build Assistants that can call models and use tools.

GitHub OpenAPI

Operations 23

GET /assistants Returns a list of assistants #
POST /assistants Create an assistant with a model and instructions #
GET /assistants/{assistant_id} Retrieves an assistant #
POST /assistants/{assistant_id} Modifies an assistant #
DELETE /assistants/{assistant_id} Delete an assistant #
POST /threads Create a thread #
GET /threads/{thread_id} Retrieves a thread #
POST /threads/{thread_id} Modifies a thread #
DELETE /threads/{thread_id} Delete a thread #
GET /threads/{thread_id}/messages Returns a list of messages for a given thread #
POST /threads/{thread_id}/messages Create a message #
GET /threads/{thread_id}/messages/{message_id} Retrieve a message #
POST /threads/{thread_id}/messages/{message_id} Modifies a message #
DELETE /threads/{thread_id}/messages/{message_id} Deletes a message #
POST /threads/runs Create a thread and run it in one request #
GET /threads/{thread_id}/runs Returns a list of runs belonging to a thread #
POST /threads/{thread_id}/runs Create a run #
GET /threads/{thread_id}/runs/{run_id} Retrieves a run #
POST /threads/{thread_id}/runs/{run_id} Modifies a run #
POST /threads/{thread_id}/runs/{run_id}/submit_tool_outputs When a run has the `status: "requires_action"` and `required_action.type` is… #
POST /threads/{thread_id}/runs/{run_id}/cancel Cancels a run that is `in_progress` #
GET /threads/{thread_id}/runs/{run_id}/steps Returns a list of run steps belonging to a run #
GET /threads/{thread_id}/runs/{run_id}/steps/{step_id} Retrieves a run step #

Documentation

📖
Documentation
https://portkey.ai/docs/introduction/what-is-portkey
📖
APIReference
https://portkey.ai/docs/api-reference/inference-api/chat
📖
GettingStarted
https://portkey.ai/docs/guides/getting-started/getting-started-with-ai-gateway
📖
APIReference
https://portkey.ai/docs/api-reference/inference-api/completions
📖
APIReference
https://portkey.ai/docs/api-reference/inference-api/embeddings
📖
APIReference
https://portkey.ai/docs/api-reference/admin-api/introduction

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/portkey/refs/heads/main/openapi/portkey-assistants-api-openapi.yml

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/portkey-assistants-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

portkey-assistants-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Portkey Assistants API
  description: The Portkey REST API. Please see https://portkey.ai/docs/api-reference for more details.
  version: 2.0.0
  termsOfService: https://portkey.ai/terms
  contact:
    name: Portkey Developer Forum
    url: https://portkey.wiki/community
  license:
    name: MIT
    url: https://github.com/Portkey-AI/portkey-openapi/blob/master/LICENSE
servers:
- url: https://api.portkey.ai/v1
  description: Portkey API Public Endpoint
security:
- Portkey-Key: []
tags:


# --- truncated at 32 KB (174 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/portkey/refs/heads/main/openapi/portkey-assistants-api-openapi.yml