OpenAI

OpenAI Agents API

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

GitHub OpenAPI
Business capability
Agent Infrastructure & Agentic Commerce AE-100

Operations 37

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 #
GET /agents/environments List agent environments #
POST /agents/environments Create an agent environment #
GET /agents/sessions/{session_id}/traces List agent session traces #
GET /agents/sessions/{session_id}/turns/{turn_id}/items List agent session turn items #

Specifications

⚙
OpenAPI
https://artifacts.apis.io/openai/openapi/openai-agents-api-openapi.yml

SDKs

📦
GitHubRepository
https://github.com/openai/openai-openapi

Schemas & Data

📊
JSONSchema
https://artifacts.apis.io/openai/json-schema/openai-session-event-schema.json
📊
JSONSchema
https://artifacts.apis.io/openai/json-schema/openai-agent-resource-schema.json
📊
JSONSchema
https://artifacts.apis.io/openai/json-schema/openai-create-environment-template-params-schema.json
📊
JSONSchema
https://artifacts.apis.io/openai/json-schema/openai-update-environment-template-params-schema.json
📊
JSONSchema
https://artifacts.apis.io/openai/json-schema/openai-environment-template-resource-schema.json
📊
JSONSchema
https://artifacts.apis.io/openai/json-schema/openai-session-resource-schema.json

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/openai:openai-agents-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

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

openai-agents-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Openai Agents API
  version: 2.3.0
  contact:
    name: OpenAI Support
    url: https://help.openai.com/
  license:
    name: MIT
    identifier: MIT
  termsOfService: https://openai.com/policies/terms-of-use
  description: 'Operations tagged Agents across 2 of this provider''s published API definitions: openai-openapi-master-2026-09-23.yml, openai-openapi-master-2026-10-12.yml. Each path carries the servers of the definition it was published in.'
servers:
- url: https://api.openai.com/v1
security:
- ApiKeyAuth: []
tags:


# --- truncated at 32 KB (480 KB total) ---
# Full source: https://artifacts.apis.io/openai/openapi/openai-agents-api-openapi.yml