# Portkey Assistants API

**Canonical:** https://apis.io/apis/portkey/portkey-assistants-api/  
**Provider:** Portkey — https://apis.io/providers/portkey/  
**Base URL:** https://api.portkey.ai/v1  
**Documentation:** https://portkey.ai/

Portkey Assistants API is one of 51 APIs that [Portkey](https://apis.io/providers/portkey/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include Assistant. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, an API reference, and a getting-started guide.

Build Assistants that can call models and use tools.

## Operations (23)

| Method | Path | Summary |
|---|---|---|
| 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 |

## Machine-readable artifacts (7)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/portkey/refs/heads/main/openapi/portkey-assistants-api-openapi.yml
- **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

## Other Portkey APIs (12)

- [Portkey Analytics > Graphs API](https://apis.io/apis/portkey/portkey-analytics-graphs-api/)
- [Portkey Analytics > Groups API](https://apis.io/apis/portkey/portkey-analytics-groups-api/)
- [Portkey Analytics > Summary API](https://apis.io/apis/portkey/portkey-analytics-summary-api/)
- [Portkey Api-Keys API](https://apis.io/apis/portkey/portkey-api-keys-api/)
- [Portkey Audio API](https://apis.io/apis/portkey/portkey-audio-api/)
- [Portkey Audit Logs API](https://apis.io/apis/portkey/portkey-audit-logs-api/)
- [Portkey Batch API](https://apis.io/apis/portkey/portkey-batch-api/)
- [Portkey Collections API](https://apis.io/apis/portkey/portkey-collections-api/)
- [Portkey Completions API](https://apis.io/apis/portkey/portkey-completions-api/)
- [Portkey Configs API](https://apis.io/apis/portkey/portkey-configs-api/)
- [Portkey Embeddings API](https://apis.io/apis/portkey/portkey-embeddings-api/)
- [Portkey Feedback API](https://apis.io/apis/portkey/portkey-feedback-api/)

## Tags

Assistant

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/portkey/portkey-assistants-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/portkey/.