# OpenAI Agents API

**Canonical:** https://apis.io/apis/openai/openai-agents-api/  
**Provider:** OpenAI — https://apis.io/providers/openai/  
**Base URL:** https://api.openai.com  
**Documentation:** https://platform.openai.com/docs/api-reference/responses

OpenAI Agents API is one of 62 APIs that [OpenAI](https://apis.io/providers/openai/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 6 JSON Schema definitions. Tagged areas include Agents. The published artifact set on APIs.io includes an OpenAPI specification, a GitHub repository, and 6 JSON Schemas.

The Agents API from OpenAI — 21 operation(s) for agents.

## Operations (33)

| Method | Path | Summary |
|---|---|---|
| GET | `/agents/environments/{environment_id}` | Retrieve an agent environment |
| GET | `/agents/environments/{environment_id}/files` | List agent environment files |
| POST | `/agents/environments/{environment_id}/files` | Create an agent environment file |
| GET | `/agents/sessions/{session_id}/subagents` | List session subagents |
| GET | `/agents/sessions/{session_id}/subagents/{subagent_id}` | Retrieve a session subagent |
| GET | `/agents/sessions/{session_id}/subagents/{subagent_id}/items` | List subagent items |
| GET | `/agents/sessions/{session_id}/subagents/{subagent_id}/turns` | List subagent turns |
| GET | `/agents/sessions/{session_id}/subagents/{subagent_id}/turns/{turn_id}` | Retrieve a subagent turn |
| GET | `/agents/sessions/{session_id}/subagents/{subagent_id}/turns/{turn_id}/items` | List subagent turn items |
| GET | `/agents` | List agents |
| POST | `/agents` | Create an agent |
| GET | `/agents/{agent_id}` | Retrieve an agent |
| POST | `/agents/{agent_id}` | Update an agent |
| DELETE | `/agents/{agent_id}` | Delete an agent |
| GET | `/agents/environments/templates` | List agent environment templates |
| POST | `/agents/environments/templates` | Create an agent environment template |
| GET | `/agents/environments/templates/{environment_template_id}` | Retrieve an agent environment template |
| POST | `/agents/environments/templates/{environment_template_id}` | Update an agent environment template |
| DELETE | `/agents/environments/templates/{environment_template_id}` | Delete an agent environment template |
| GET | `/agents/sessions` | List agent sessions |
| POST | `/agents/sessions` | Create an agent session |
| GET | `/agents/sessions/{session_id}` | Retrieve an agent session |
| POST | `/agents/sessions/{session_id}` | Update an agent session |
| DELETE | `/agents/sessions/{session_id}` | Delete an agent session |
| GET | `/agents/sessions/{session_id}/artifacts` | List agent session artifacts |
| GET | `/agents/sessions/{session_id}/artifacts/{artifact_id}` | Retrieve an agent session artifact |
| DELETE | `/agents/sessions/{session_id}/artifacts/{artifact_id}` | Delete an agent session artifact |
| GET | `/agents/sessions/{session_id}/artifacts/{artifact_id}/content` | Retrieve agent session artifact content |
| GET | `/agents/sessions/{session_id}/events` | Stream agent session events |
| POST | `/agents/sessions/{session_id}/events` | Create agent session input events |
| GET | `/agents/sessions/{session_id}/items` | List agent session items |
| GET | `/agents/sessions/{session_id}/turns` | List agent session turns |
| GET | `/agents/sessions/{session_id}/turns/{turn_id}` | Retrieve an agent session turn |

## Machine-readable artifacts (8)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/openai/refs/heads/main/openapi/openai-agents-api-openapi.yml
- **GitHubRepository** — https://github.com/openai/openai-openapi
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/openai/refs/heads/main/json-schema/openai-session-event-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/openai/refs/heads/main/json-schema/openai-agent-resource-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/openai/refs/heads/main/json-schema/openai-create-environment-template-params-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/openai/refs/heads/main/json-schema/openai-update-environment-template-params-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/openai/refs/heads/main/json-schema/openai-environment-template-resource-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/openai/refs/heads/main/json-schema/openai-session-resource-schema.json

## Other OpenAI APIs (12)

- [OpenAI Responses API](https://apis.io/apis/openai/openai-responses-api/)
- [OpenAI Moderations API](https://apis.io/apis/openai/openai-moderations-api/)
- [OpenAI Batch API](https://apis.io/apis/openai/openai-batch-api/)
- [OpenAI Vector Stores API](https://apis.io/apis/openai/openai-vector-stores-api/)
- [OpenAI Uploads API](https://apis.io/apis/openai/openai-uploads-api/)
- [OpenAI Realtime API](https://apis.io/apis/openai/openai-realtime-api/)
- [OpenAI Evals API](https://apis.io/apis/openai/openai-evals-api/)
- [OpenAI Videos API](https://apis.io/apis/openai/openai-videos-api/)
- [OpenAI Conversations API](https://apis.io/apis/openai/openai-conversations-api/)
- [OpenAI Containers API](https://apis.io/apis/openai/openai-containers-api/)
- [OpenAI ChatKit API](https://apis.io/apis/openai/openai-chatkit-api/)
- [OpenAI Skills API](https://apis.io/apis/openai/openai-skills-api/)

## Tags

Agents

---

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