Home / Servers / OpenAI API / update_agent
Update an agent
An MCP tool from the OpenAI API server, hosted on mcp.hjlabs.in.
Update an agent Updates a reusable agent. See agent configuration. [POST /agents/{agent_id}]
Name on the gateway: openai_api__update_agent · may change things.
Parameters
| Name | Type | Description |
|---|---|---|
agent_id required | string | The ID of the reusable agent. |
experimental | object | Experimental settings to merge by key. Omitted settings keep their current… |
model | string | The model to use for the agent. The requested model name is preserved. |
reasoning | object | Configuration for model reasoning. Omit to keep the current settings; pass… |
text | object | Configuration for text generated by the agent. |
service_tier | auto | default | flex | priority | fast | ultrafast | The service tier used for model requests. |
instructions | string | Additional instructions appended to the agent's default base instructions.… |
multi_agent | object | Configuration for creating and coordinating subagents. |
compaction | object | Context compaction settings. Omit to keep the current settings. A supplied… |
metadata | object | Replaces all metadata. Omit to leave unchanged, or pass null or {} to clear… |
name | string | A replacement name. Omit to leave unchanged, or pass null to clear it. |
tools | array | Replaces the tool list. Omit to leave it unchanged, or pass null to clear it.… |
How to call it
Through the Smart Gateway, any client can run it by name with call_tool, or let the gateway find it with search_tools:
{
"name": "openai_api__update_agent",
"arguments": {
"agent_id": "…"
}
}Or connect the OpenAI API server directly, which lists 371 tools including this one:
claude mcp add --transport http hj-openai-api https://mcp.hjlabs.in/mcp/openai-api \
--header "Authorization: Bearer YOUR_API_KEY"Try asking
Use the update an agent tool with agent_id set to ….