Sebtembar 10, 2026

Introducing the Agents API

Build and run cloud agents with the Codex harness, fully managed by OpenAI.

Soo kacaya…

As we’ve scaled Codex and ChatGPT for Work to millions of people around the world, we’ve learned what it takes to make long-running agents work well in practice. Useful agents need a powerful harness that manages context, uses tools efficiently, and coordinates subagents. They also need infrastructure that keeps them running reliably for days, with environments where they can work with files, run code, and save intermediate results.

Today, we’re introducing the Agents API⁠(ku furmaa daaqad cusub) in public beta, bringing that same harness and infrastructure that powers Codex to developers through a simple, flexible API.

What our customers are saying about Agents API

1 marka loo eegay 8

“Markii aannu adeegsanay API-ga Wakiillada, dhibcaha qiimayntayadu waxay ka kaceen 0.71 ilaa 0.85. Taageerada wakiilo-hoosaadyada ee API-gu waa kuwa heer sare ah, waxayna si weyn u dedejiyeen habsocodkayaga shaqo. Markii hore, dejintayadii hore aad bay ugu adkayd in lagu kormeero laguna agaasimo wakiilo-hoosaadyada, balse API-yada cusub waxay daahitaanka naga yareeyeen 4 jeer. Waqti dheer ayaannu ku bixinnay madhaafaanimada arrintan, habsocodyada shaqo ee wakiillo-hoosaadyaduna waxay isla markiiba dhaliyeen horumar aad u weyn.”

Jack Weissenberger, Sarkaalka Sare ee Teknolojiyadda, Ciridae

“Beddelidda ganacsiyada ka jira dunida dhabta ahi waxay ka dhigan tahay in AI-ga laga dhex hawlgeliyo habsocod kasta oo shaqo oo qaab kasta leh. API-ga Wakiilladu wuxuu bixiyaa dejinta dhammaystiran; deegaanka, macnaha guud oo mahadhada isticmaaluhuna annaga ayay inoo sugnaatay. Madashayada AI-ga ee Nexus, waxaannu hadda saacado gudahood wakiillo uga hawlgelinnaa warshado kala duwan, laga bilaabo adeegyada guryaha ilaa naqshadaynta dhismayaasha.”

Rasmus Wissmann, Sarkaalka Sare ee Teknolojiyadda, Long Lake

“API-ga Wakiillada wuxuu noo saamaxay inaannu si ka duwan sidii hore uga fikirno qaabaynta habsocodyada shaqo ee adag ee tallaabooyinka badan leh. Waxaannu hore u qori jirnay silsilado weydiimo ah oo aannu ku maamuli jirnay codsiyadayada qalabka, laakiin hadda wakiillada waxaannu si toos ah ugu adeegsan karnaa koodhkayaga, si la mid ah sida Codex uga shaqeeyo kombiyuutarkaaga dhabsaarka. Wuxuu durba naga caawiyey xallinta dhibaatooyin dhawr ah oo haddii kale nooga baahnaan lahaa inaannu dhisno kaabayaal wakiil oo gaar ah.”

Cole Striler, Agaasimaha Injineeriyada, WithCoverage

“Waxa si gaar ah uga dhex muuqday tijaabadayada waxay ahayd sida dabiiciga ah ee API-ga Wakiilladu u maareeyey culaysyada shaqo ee sida kadiska ah u bata. Waxaannu shaqada u qaybin karnay boqollaal wakiil, si aan isku mar ahayn ayaan u socodsiin karnay, natiijooyinkana goor dambe ayaan u ururin karnay, annagoo aan kaabayaasha shaqo-la’aan ka dhigayn inta u dhexaysa xilliyada mashquulka badan.”

Dmitry Khanukov, Aasaase-wadaag & Sarkaalka Sare ee Teknolojiyadda, Dwelly

“Helitaanka kalsoonida macaamiishu aad bay muhiim ugu tahay adeegyada maaliyadeed. API-ga Wakiillada ee OpenAI wuxuu noo saamaxaa inaannu dhisno wakiillo lagu kalsoonaan karo, taas oo macaamiisha siinaysa kalsooni ay ugu adeegsadaan wax-soo-saarka. Markii aannu dejinta dhammaystiran ee wakiilka ka soocnay deegaanka tijaabo, waxaannu jawaabaha wakiilka ee fashilmay yaraynay 86%.”

Serhii Shchoholiev, Injineer Hoggaamineed, Hypha

“Nash gudahiisa, waxaannu ka hawlgelinnaa kumannaan wakiillo AI ah oo muddo dheer shaqeeya kuwaas oo maamula boqollaal milyan oo gaarsiinno ah oo ka dhex socda shabakadaha saadka caalamka. API-ga Wakiillada ee OpenAI wuxuu na siiyaa kal-fadhiyada joogtada ah iyo lakabka agaasinka ee aannu ugu baahan nahay wakiillada sida joogtada ah uga shaqeeya wax-soo-saarka, iyagoo maamulaya macnaha guud, soo-kabashada iyo fulinta tallaabooyin badan; Nash-na wuxuu bixiyaa qalabka iyo deegaanka fulinta ee ku xira dunida dhabta ah. Tani waxay wakiilladayada u saamaxdaa inay sababeeyaan, tallaabo qaadaan, soo kabtaan oo iska kaashadaan habsocodyo shaqo oo adag oo socon kara saacado ama maalmo. Wakiilladani waa kaabayaal wax-soo-saar oo wada hawlaha saadka ee lama-huraanka u ah hawlgalka shuraakadayada.”

Aziz Alghunaim, Aasaase-wadaag & Sarkaalka Sare ee Teknolojiyadda, Nash.ai

Build cloud agents with a single API call

With the Agents API, you can create a production-ready agent in a single API call by specifying the task, model, tools, and environment:

JavaScript

1import OpenAI from "openai";
2
3const client = new OpenAI();
4
5const session = await client.beta.agents.sessions.create({
6  agent: {
7    model: "gpt-6-astra",
8    tools: [
9      {
10        type: "mcp",
11        server_label: "observability",
12        transport: {
13          type: "http",
14          server_url: "https://observability.example.com/mcp",
15        },
16      },
17    ],
18    multi_agent: { enabled: true, max_concurrent_subagents: 3 },
19  },
20  vault_ids: ["vault_YOUR_VAULT_ID"],
21  environment: {
22    type: "openai_hosted",
23    capability_directories: ["/workspace/capabilities/skills"],
24  },
25  input:
26    "Investigate service-api’s elevated 5xx rate over the last 30 minutes. " +
27    "Delegate deployment, error, and dependency analysis to subagents. " +
28    "Save findings, evidence, and recommended mitigation in /workspace/outputs.",
29});

OpenAI hosts and maintains the harness. You choose the agent’s compute environment: in an OpenAI-managed sandbox, on your own infrastructure, or with one of our sandbox partners. The Agents API gives you a strong foundation for building agents on top of our optimized agent harness and infrastructure, so you can focus on the tools, knowledge, and workflows that make your agent unique.

Abka ayaa hawlo u dira API-ga Wakiillada, kana hela dhacdooyin iyo wax-soo-saar. API-ga Wakiilladu wuxuu socodsiiyaa dejinta dhammaystiran ee Codex ee la maamulo, isagoo wicitaannada qalabka u dira deegaan tijaabo kana hela natiijooyinka qalabka. Abku wuxuu maamulaa xisaabinta iskeed loo martigeliyo. — API-ga Wakiillada wuxuu wakiilladaada ku xoojiyaa isla dejinta dhammaystiran iyo kaabayaasha ka dambeeya Codex.

Choose your agent environment

Different workloads need different compute, storage, and deployment options. The Agents API lets you choose a sandbox that fits your application.

We’re partnering with ecosystem providers⁠(ku furmaa daaqad cusub), including Blaxel, Cloudflare, Daytona, DigitalOcean, E2B, Modal, Oracle, Runloop, and Vercel, to provide first-class integrations for a range of needs:

Fully managed environments or deployments within your VPC
Specific file and secret storage mechanisms
Different CPU, GPU, and memory configurations, with performance, cold-start, and cost profiles to match your company’s workflow.

Shuraakada deegaanka tijaabo: Modal, Cloudflare, Daytona, Blaxel, Runloop, Vercel, Oracle, E2B iyo DigitalOcean. — API-ga Wakiillada wuxuu bixiyaa isku-xidhyo heer sare ah oo dhex mara bixiyeyaasha caanka ah ee nidaamyada deegaanka.

OpenAI hosted sandboxes

For developers who want to get started quickly and scale efficiently, we’re also introducing the OpenAI hosted sandbox⁠(ku furmaa daaqad cusub). This leverages the same sandboxing infrastructure that powers Codex and ChatGPT.

OpenAI provisions and manages the sandbox, giving your agent a secure and performant environment to run code, work with files, and produce artifacts. These sandboxes can be flexibly configured with your files, packages, skills and plugins to give the agent what it needs to complete the task.

Build with an evolving Codex harness

Taking advantage of new model capabilities often means reworking your harness, taking valuable time away from improving your application. The Agents API provides versioned access to these capabilities with each model launch. We maintain and continuously improve the harness alongside our models, helping your agents get better performance from every upgrade. For example, recent improvements to the harness include:

Keep agents working across long sessions

To support models working for hours, we’ve built context management that helps agents carry relevant information across longer sessions. The Agents API automatically compacts⁠(ku furmaa daaqad cusub) earlier context as a session approaches its context limit, preserving information the agent needs to continue. Developers can build workflows that span multiple context windows without implementing their own compaction logic.

Help agents efficiently use more tools

The Agents API helps agents find the right tools and use them efficiently. Tool search⁠(ku furmaa daaqad cusub) loads relevant tool definitions as needed, helping reduce token usage and cost while preserving the model’s cache. Once tools are available, programmatic tool calling⁠(ku furmaa daaqad cusub) lets agents run calls in parallel, chain related operations, and filter or combine results in code so they can work through large volumes of data while bringing only the relevant results back into context. The Agents API supports MCP, custom functions, and built-in tools like web search.

JSON

1"agent": {
2  "tools": [
3    {
4      "type": "mcp",
5      "server_label": "openai_docs",
6      "transport": {
7        "type": "http",
8        "server_url": "https://developers.openai.com/mcp"
9      }
10    },
11  ]
12}

Let agents parallelize work with subagents

With multi-agent support⁠(ku furmaa daaqad cusub), the Agents API can break complex tasks into independent pieces and delegate them to subagents that work in parallel. Each subagent maintains its own context, helping it stay focused on its assignment, while the main agent coordinates their work and brings the results together. This can speed up research, analysis, and coding tasks that benefit from parallel work, without requiring you to build your own orchestration.

JSON

1"agent": {
2  "model": "gpt-6-astra",
3  "multi_agent": {
4    "enabled": true,
5    "max_concurrent_subagents": 3,
6  }
7}

An open-source foundation

The Agents API is powered by the open-source Codex harness, giving developers visibility into the core logic that coordinates model calls, tools, and context. With the Agents API, OpenAI operates and maintains that harness while developers can inspect and learn from its public codebase⁠(ku furmaa daaqad cusub).

Start building

Agents API is available in public beta today to all developers. There are no additional fees for using the Agents API – you simply pay for the tokens and tools your agents use, as outlined on our pricing page⁠(ku furmaa daaqad cusub).

Explore the Agents API overview⁠(ku furmaa daaqad cusub) to learn more, or follow the quickstart⁠(ku furmaa daaqad cusub) to get started and bring the harness behind Codex into your own agents.

During the public beta, we’ll iterate quickly based on your feedback as we work toward general availability. Let us know what’s working, where you’re running into friction, and what you need to build and run your agents in production.

Qoraa

OpenAI

Sii wad akhrinta

Eeg dhamaan

Now everyone can put data to work

BadeecadSeb 10, 2026

Introducing ChatGPT for Financial Services

BadeecadSeb 10, 2026

GPT-Live-1 API | Green-blue cover | Option 038

Build more natural voice experiences with GPT‑Live‑1 in the API

BadeecadSeb 10, 2026